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articles on the first two HP instruments designed to operate on the HP-IL. Model 3468A t the 
subject of the article on page 3, is a digital multimeter, a basic instrument that measures 
voltage, current, and electrical resistance, Besides its HP-IL connection, the3468A is interest- 
ing for its production process- The subassemblies that go into it aren't tested and adjusted 
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but by conventional manufacturing wisdom if s risky to the point of foolhardiness. To make the 
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system, the 3056DL Data Logger; it's described in the article on page 13, 
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While HPMAIL is for computer users, HPToolset is designed by programmers for programmers. Many 
software subsystems are needed in program development. A typical list includes an editor a compiler, a 
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like one subsystem, saving program mers a great deal of time and thereby improving their productivity. The story 
of HPToolset begins on page 30. 
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A Portable, Low-Cost, High-Performance 
Digital Multimeter for the HP-IL 

HP's first HP-IL instrument is the result of new design and 
manufacturing approaches. This DMM electronically 
calibrates itself, measures ac and dc voltages and currents, 
makes four-wire and two-wire resistance measurements, 
and uses a liquid-crystal display to output data, 
measurement units, and alphanumeric messages. 

by Jack P. Trautman and Lawrence A. DesJardin 



PORTABLE. ACCURATE MEASUREMENTS of volt- 
ages, currents, and resistances are a necessity for 
electronic service personnel and other users operat- 
ing in the field. Large amounts of data often must be col- 
lected and analyzed. If this data can be output by the 
measuring device directly to a portable computer, the need 
for considerable manual effort to record the data and later 
enter it for analysis can be avoided. Low instrumentation 
cost is important because, unlike a laboratory situation 
where many persons can have convenient access to one 
piece of equipment, field personnel each require a dedi- 
cated set of equipment. High reliability can also reduce 
field support costs. 

To satisfy these needs, HP developed a low-cost serial 
interface, the Hewlett-Packard Interface Loop (HP-IL). ' This 
interface allows bench measurements by a high- 
perlormance digital multimeter to be coupled to the ad- 
vanced computational power of a handheld computer. The 



3468A Multimeter (Fig. 1) is the first HP instrument de- 
signed for use on the HP-IL. It is a low-cost r autoranging. 
D^-to-aVz-digit five-function DMM with I-/1V sensitivity 
designed for bench and portable applications. A rack- 
mount version with identical features, the 3468B t is also 
available. This microprocessor-based instrument can mea- 
sure dc voits T true-rms ac volts, Uvo-and four-wire ohms, 
and ac and dc current. Its simple, fast, electronic calibration 
eliminates manual adjustments to provide a lower cost of 
ownership. The standard HP-IL interface on the 3468 A al- 
lows complete programmability with small computers such 
as the HP-42 Handheld Computers or the more powerful HP 
Series 80 Personal Computers, 

Features 

Several important features are contained in the 3468 A's 
small package. These include: 
■ HP-IL for low-cost automation. When the 3468A is con- 




Fig. 1. The HP Model 346BA Mul- 
timeter is HP's first HP-IL instru- 
ment. It has an alphanumeric 
liquid-crystal display, measures 
ac and dc voltage and current, 
and determines resistance by 
both two-wire and four-wire 
methods 
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nected to a handheld computer through the HP-1L. 
software can easily be developed that stores and analyzes 
data for many applications. For example* to measure 
temperature, an HP-41 can be used to linearize the output 
of a transducer device measured by the 3468 A. Then, the 
HP-41 can be programmed to output the results in de- 
grees Celsius or degrees Fahrenheit on the display of the 
3 468 A, For audio and telecommunication applications, 
the 3 468 A can display power in dBm referenced to any 
impedance by using a simple HP-41 program- For appli- 
cations such as testing resistor tolerance or performance 
of a device, the HP-41 can easily get data from the 3468 A, 
perform a percent-error calculation, and display the re- 
sults in percent on the 3 468 A. The software and 
documentation for the 3468A include bar-code pro- 
grams for the HP-41 that reduce system programming 
time. Peripheral devices, such as the 82 162 A Thermal 
Printer and 82161A Cassette Drive, are available to ex- 
pand an HP-IL system to provide data record ing and mass 
storage, 
i Interrupt capability. The front-panel SRQ key on the 
3468 A allows the user to Interrupt a running program on 
the computer controlling the 3468A and cause it to exe- 
cute another program. 

High-performance bench measurements. The 3468 A can 
measure dc and true-rms ac voltage in several ranges 
from 0.3V to 300V full scale, with 1-^V to 1-mV sensitiv- 
ity, respectively. This wide dynamic range enhances the 
number of measurements that can be made with the 
3468A.The 3468A's ac converter is true-rms-responding. 
and provides accurate detection of nonsinusoidal 
waveforms with crest factors up to 4: 1 . With a bandwidth 
of 100 kHz on all ranges and an extended bandwidth of 
300 kHz on the 30V range, the 3468A provides a broad 
range of ac detection. Resistance measurement ranges 
from 300 ohms to 30 megohms with respective sen- 
sitivities of 1 milliohm to 100 ohms are available for both 
two- wire and four-w T ire measurements. The four- wire 
ohms function can be used to reduce errors caused by 
lead resistance and the two- wire ohms function is conve- 
nient for bench measurements. Both dc and true-rms ac 
current measurements are provided up to 3 A- All func- 
tions on the 3468 A incorporate fast autoranging to pro- 
vide answers quickly and accurately. 
Smart display, The 3468A DMM uses an easy-to-read. 
14-character, alphanumeric liquid-crystal display that 
provides measurement units as part of the reading for 
unambiguous answers, Annunciators below the reading 
show instrument status and the status of the HP-IL inter- 
face. With the HP-IL interface* words or messages can be 
arbitrarily displayed on the 34 68 A for prompting or dis- 
playing answers in calculated units such as degrees or 
revolutions per minute. 

Rechargeable battery. The optional battery pack in- 
cludes a rechargeable battery and charging circuitry to 
allow up to five hours of continuous portable measure- 
ments* For applications in the field, the 3468A and other 
battery-powered HP-IL devices can be set up to provide a 
completely portable measurement system. 
Electronic calibration. Complete calibration of the 
3 46 8 A is done electronically without any internal man- 
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Fig. 2. Simplified block diagram of 3468A. 

ual adjustments, All functions can be calibrated either 
from the front panel or remotely by an automatic calibra- 
tion system. 
e Self- test The 3468 A has a built-in self-test feature in* 
itiated by pressing the TEST/RESET key on the front 
panel. A comprehensive check of both analog and digital 
circuits is performed while activating all display seg- 
ments. Upon successful completion of self-test t the mes- 
sage SELF TEST OK is displayed, 

A Look at the Design 

The 3468 A achieved its goals of low cost, reliability, and 
high performance by a conscious effort to select each com- 
ponent of the voltmeter not only in terms of performance, 
but also in terms of producibility^ 

A look at Fig. 2 reveals that the 3468 A'$ block diagram is 
similar to the block diagram of a conventional voltmeter. 
The input signal is transformed by the signal conditioning 
circuitry of the front end to a voltage between +10V and 
— 10V (±3V in the ac modes]. This voltage is digitized by 
the anaiog-to-digital (A-to-D] converter to the resolution 
selected by the user. The microprocessor controller linearly 
corrects this value using constants that have been stored in 
the nonvolatile calibration memory for this particular func- 
tion and range. The corrected value is shown on the liquid- 
crystal display of the front panel and can be output onto the 
HP-IL. 

The photograph of the interior of the 3468A (Fig, 3) 
shows that the design of the instrument is much less con- 
ventional. A single printed circuit board houses all the 
electronics but the display. Several contrasts with conven- 
tional voltmeters can easily be noted. The first is the ab- 
sence of Teflon standoffs, previously considered a 
necessity to ensure high impedances on precision analog 
boards. A special process was developed that guarantees 
high impedances across the board's surface as long as the 
surface remains clean. A vigorous program of instituting 
clean handling was adopted to safeguard the integrity of the 
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HP-IB Version of 3468A 



The 3478A Muttimelf ow-cost HP-IS (fEEE 488) 

progrr ^easuremenis A compan- 

ion product to the 34- ay ano measurement 

63, the micro processor- based 3478A *s an autorangtng, 
i git. five-function digital multimeter designed for au- 
tomated testing in production or research and development, its 
simple, fast electronic calibration eliminates atJ manual adjust- 
ments to provide a lower cost of ownership 

High Performance at Low Cost 

The 3478A can measure dc voltage with 100-nV sensitivity on 
the 30-mV range up to a maximum reading of 300V. It can mea- 
sure ac voltage from 300-mV full-scale range with 1 ^V resolutron 
up to 300 Vims. This wide dynamic range minimizes the amount of 
signal conditioning required to detect low-level signals and higher 
voltages Either two-wire or four-w^re resistance measurements 
can be selected with a maximum range of 30 megohms and a 
100-^0 sensitivity on the 30-ohm range. Both 300-mA and 3A 
ranges of ac and 6c current are provided, completing the function 
capability of the 3478A, Fast auto ranging improves system 
throughput by minimizing the time to select the correct range. 

The 3478A can perform production tests or acquire experimen- 
tal data at 71 read ings.- second with 3 1 /2-digrt resolution, or obtain 
33 re ad ings/ second with 1 30 dB of noise rejection using 4Vz-d»Qit 
resolution. Increasing the resolution of the 3478A to SYs digits 
reduces the measurement speed to 4.4 readings/second. 

Designed for HP-IB Systems 

All of the performance of the 3478A can be controlled over the 
HP- IB by a wide range of compatible computers. Complete pro- 
gram mabiHty of functions, ranges, and other modifiers on the 
34 78 A makes it ideal for use in a fully automatic test system. 

With an extensive set of service request (SflQ) interrupt 
capabilities, including data ready, front- panel SRQ key. and 
power-on SRQ, the 3478A allows more flexibility in a system. The 
data-ready service request of the 34 7 8 A. can be programmed to 
interrupt the computer after a measurement has been taken, 
allowing more efficient use of computer time. The front-panel SRQ 
key lets a system operator interrupt the computer from the 
3478A h s front panel. The 3478A can also flag the computer at 
power-on to indicate loss of power, 

Switchable front and rear terminals on the 3478A permit conve- 
nient measurements at a bench using the front terminals or sys- 



3is, The setting of the f re 
ad switch on tne 3478A s front panel can be sensed re- 
motely over the HP-SB, so both sets of terminate can be effectively 
used in any system con figure: 

A voltmeter COMPLETE output on the rear panel of the 3478A 
provides a signal after a measurement is completed This output 
can be used to advance a scanner to the next channel without 

"3 Speed An EX- 
TERNAL TRIGGER input is also provided on the 3478A to initiate 
measurements and synchronize with an external devica 

Fast Electronic Calibration 

Ltke The 3468A, complete calibration of the 3478A is done 
electronically without any internal manual adjustments. All func- 
tions can be calibrated either from the front panei or remotely in an 
automatic calibration system. 




Fig, 1 . The HP Model 3478 A Multimeter is me HP-IB version of 
HP's new, low-cost, high-performance digital multimeter de- 
sign. It combines the display, measurement, and electronic 
calibration features of its companion instrument, the 3468 A , 
with HP-IB operation capabilities and higher performance 



boards. Elimination of the standoffs significantly reduces 
the amount of manual labor required to assemble the volt- 
meter, and thus lowers its cost. 

Electronic Calibration 

Even more conspicious is the absence of any manual 
adjustments or "tweaks." This is achieved by a design that 
forces significant imperfections (e.g., voltage offsets, im- 
perfect resistor matching] to be linear errors, that is, errors 
of offset and gain. This allows readings to he corrected by 
simple math routines that subtract the offset value and then 
perform a multiplication to scale the final answer correctly 
as follows: 

R = (R'-Y]G 



where R is the final calibrated reading, R' is the raw un- 
calibrated reading, V is the offset correction factor, and G is 
the gain correction factor. 

The correction factors Y and G are unique for each dc and 
ohms range, and are stored in a CMOS memory that is kept 
continuously powered by a lithium battery [seen in Fig. 3), 
Even w T hen the rest of the instrument is not powered , the 
memory contents can be kept valid for over ten years by the 
lithium battery. The values of Y and G are derived by the 
3468A*a microprocessor and loaded into the memory by an 
electronic calibration procedure. This allows the user to 
calibrate the instrument without removing the covers or 
turning a single screw T . 

Initially, the user sets the instrument to the function and 
range to be calibrated. The offset must be calibrated first, so 
a short is placed across the input terminals and the user 
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Lithium 
Battery 




Fig. 3. interior of 3468 A. The elec- 
tronics system, with the exception 
of the liquid-crystal display, is 
mounted on a single printed circuit 
board. No Teflon™ standoffs or 
potentiometers are used, 



enables the CAL function, The 3468 A takes a single mea- 
surement, recognizes that the reading is close to zero, as- 
sumes that the user wishes to calibrate the offset, and dis- 
plays o.uuouo? The user now presses the SQL TRIG key to 
verify that zero was indeed the user's target value. The 
3468A averages ten SVz-digit readings to derive the new Y 
value, and stores this constant in the calibration memory, 
The display then reads CAL DONE, and returns to normal 
operation. 

Using an external standard, the user can now apply the 
full -scale value of that particular function and range to the 
meter and repeat the previous procedure. Again, ten 5Vi- 
digit readings are taken and averaged. However, this time a 
divide operation is performed to determine the value of G, 
and the new value is stored into the calibration memory. 

It is possible that a user may own a standard that is very 
stable and known in value, but not exactly equal to the 
3468 A's full-scale value. Furthermore, many standards are 
in cardinal values of 1 or 1(J instead of 3. the 346&A's full 
scale* To accommodate both of these common situations, 
the 3468A quickly measures the applied signal and dis- 
plays a target value of 100000? or 300000?. whichever is 
closest to the measured value. Using the front-panel's ft 
and 4} keys, the user can then increment or decrement the 
display to the exact value of the standard used. Pressing the 
SGL TRIG key then commands the instrument to call brate to 
the altered target value. 

Calibration of the ac modes is done in a slightly different 
manner. On ac ranges, the nonlinearitv of the true-rms 
converter allows it to operate accurately only from one- 
tenth to full scale. A shorted input would give an inaccurate 
V value, as can be seen in Fig. 4. In many conventional 
voltmeters, the ac calibration procedure requires that the 



applied signal be varied between one-tenth scale and full 
scale while a technician adjusts two interactive controls. To 
ca I! brate all the ac modes on the 3468 A . a singl e 3 Vac signal 
is applied. The target value can be adjusted to the exact 
value of the signal, using the 1> and 4> keys, and then 
pressing the SGL TRIG key will calibrate all ac functions, 
Internally, the 3468A switches the ranges so that it has 
one full-scale reading and one tenth-scale reading, much 
like the technician calibrating a conventional voltmeter. 
However, instead of having to converge on the correct con- 
stants iterati vely. the 3468 A solves two simultaneous equa- 
tions exactly for Y and G. This can be done because most of 
the uncalibrated inaccuracies are common to all ac voltage 
and current ranges. The uncalibrated reading taken on the 
3Vac range will be close to full scale and is labeled FS. The 
uncalibrated reading taken on the 30Vac range will be close 
to one- tenth scale and is labeled TS. T is the target value. 
With the correct choice of Y and G s the following equations 
must be true: 

T - (FS-Y)G 

T/lQ = (TS-Y)G 
The 3468 A solves for G first, Thus, 

G = 0.9T/(FS-TS] 
and Y is then solved for by: 

Y = FS - T/G 
When these constants are loaded into the calibration mem- 
ory, the display reads CAL DONE and returns to normal 
operation, All of the calibration procedures can also be 
performed over the interface loop, 

Much design effort was expended to insure the integrity 
of the calibration memory once the instrument is calibrated. 
To prevent unintentional writes into the memory, a switch 
located on the rear panel must be placed into the enable 
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Fig. 4. On ae ranges , the response of the true-rms convener 
is not linear below one-tenth full scale as shown above. The 
electronic calibration technique used in the 3468 A takes two 
values corresponding to the one-tenth full-scale and full '-scale 
readings and then solves two simultaneous equations (see 
text) to derive the true V -intercept and gain (slope). 

position to allow the processor to write to the memory. This 
hardware failsafe prevents the user from unintentionally 
calibrating the instrument or altering the memory via the 
interface loop. 

Although the 346BA is designed to withstand large elec- 
trostatic discharges (ESD), secondary safeguards are insti- 
tuted for the calibration memory. Because the 256 x 4-bit 
memory selects a row of data at a time, it is possible that an 
entire row of data could be altered during ESD. For this 
reason, the data is addressed so that the calibration con- 
stants of any particular function and range are all located 
within the same row, If this row of data is altered, only that 
function and range will be uncalibrated, thus avoiding the 
need for recalibrating the entire instrument Whenever the 
instrument is placed in that function and rangp. the CAI. 
annunciator on the display is enabled, warning the user that 
the reading is no longer valid. Simultaneously, the appro- 
priate bits are set in the 346BA"s status bytes to notify the 
interface loop controller. 

Besides ESD. there is also a small chance that an alpha 
particle or a cosmic ray may alter a single bit of the memory. 
To protect against this rare occurrence, the two constants for 
each function and range have parity bits associated with 
them so thai the 3468A"s microprocessor can locate single- 
bit errors and detect double-bit errors. The processor can 
correct a single-bit error in a calibration constant itui 
the instrument will remain calibrated. If the processor de- 
tects more than a single-bit error, the CAL annunciator is 
displayed and the error bits are set to warn the user that the 
readings are uncalibrated. When this type of error is de- 
tected, the processor uses default values of zero for Y and 
one for C f 

Electronic calibration not only simplifies calibration for 
the user but, by eliminating manual adjustments, the long- 
term stability and reliability of the product are improved, 
Furthermore, since the calibration routines can compensate 



for gain errors as high as 4.5%, many components can be 
chosen for their good stability and initial accuracy becomes 
npncritkah Potentiometers are not the only parts to be 
eliminated: there are neither jumpers to be inserted or re- 
moved nor components with individually selected values 
in the 3468A. 

Microprocessor Design 

It is principally by extensive use of the 3468 A*s micro- 
processor that such high performance b realized at low 
cost Since the entire instrument is isolated from the HP-IL 
at the loop interface, there is no electrical reason why the 
system processor must be separate from the signal proces- 
sor, as required in a guarded HP- IB (IEEE 488) instrument. In 
the 3468A. these tasks are combined and executed by a 
single 8-bit microprocessor. 

Fig. 2 also shows how the processor interfaces with other 
sections of the multimeter. Besides executing instructions 
as they appear over the interface loop, monitoring the 
keyboard, and operating the display (typical system opera- 
tions in a conventional system voltmeter), the processor 
implements a multislope analog-to-digital (A-to-D) al- 
gorithm? and configures the front-end switches for proper 
signal conditioning (typical signal functions). The proces- 
sor also performs all the electronic calibration procedures 
and monitors the 50760-Hz switch so that it chooses the 
A-to-D algorithm having the proper power- line- frequency 
rejection. 

A hardware failsafe counter is added to reset the proces- 
sor if it hangs up (possibly done by erroneously executing 
* mli* in .* lookup table). If the keyboard is not scanned at 
least every 2.5 seconds, this counter resets the processor to 
its initial state, 

Since many functions of the :H68A need dedicated con- 
trol for finite periods of time, many tasks of the processor 
appear to be in conflict with each other, The most difficult 
conflict to resolve is that of executing the A-to-D algorithm 
[a dedicated operation) while still monitoring the keyboard 
and interface loop for new commands, and executing them 
Since a high-precision A-to-D conversion can take up to 400 
milliseconds, a key press can be missed entirely if it occurs 
during a conversion. Also, to have to wait 4DQ ms before a 
loop command can be processed is unacceptable, 

This conflict is resolved by adding a constraint so that 
any key presses or loop activity abort the ana log -to- digital 
conversion, and the command is executed before another 
conversion begins. To guarantee that both the loop and the 
keyboard are monitored during a conversion, the HP-IL IC 
chip is allowed to interrupt the processor when loop data is 
available, and the A-to-D algorithm firmware was modified 
so that the keyboard is scanned between integration 
periods. Thus, the maximum time between scans does not 
exceed 20 milliseconds, which is less than the minimum 
duration of a manual key press, 

To increase the usefulness of the 3 468 A in an HP-IL 
system, two other features are included in its design, A 
front- panel SRQ key allows the user to initiate a service 
request to the loop controller from the front panel and have 
the ability to write alphanumeric characters to the 3468A f s 
display remotely from the loop controller. 
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The Philosophy Behind The Design 



Early in the definition phase of the 3468A Digital Multimeter, 
very aggressive goafs for low cost, reliability, and quality were set 
without sacrificing any of the measurement performance objec- 
tives. This was done to satisfy the cost pressures of the mar- 
ketplace, and because high quality and reliability are perfor- 
mance measures that users are demanding. At this same time, 
HP's Loveiand. Colorado facility was taking a close took at its 
design and manufacturing philosophies, trying to better under- 
stand how to design more quality and easier producibility into its 
new products and manufacturing processes, 

The 3468A was chosen as a vehicle to change design and 
manufacturing strategies and demonstrate that quality is truly the 
key to achieving low manufacturing cost and high productivity 
simultaneously without sacrificing the product's measurement 
performance. The goal of this project was not only to develop a 
product that made a significant technical contribution, but to 
apply what was learned to improve future product design and 
manufacturing, 

Definition Phase 

Crucial to meeting these goals and increasing the perfor- 
mance/pnce ratio is a proper instrument definition- In a con- 
ventional definition phase, technologies and design alterna- 
tives are investigated with the primary goal of meeting the mea- 
surement objectives, At this time, there is usually less emphasis 
placed on quality and manufacturability issues. However, in the 
case of the 346SA. after a technique was demonstrated to meet 
the measurement objectives, it was also carefully scrutinized for 
manufacturability. If it did not meet all of the project objectives, it 
was rejected, This ensured that the 3468A definition was not only 
well suited for the marketplace, but also an ideal vehicfe for 
improving product development and production philosophies. 

Out of this definition phase came several dominant objectives 
that are the essence of the 3468A's design. The first objective was 
to minimize the number of components used in the product It was 
felt that minimizing the component count would help maximize 
reliability, since overall product reliability is the sum of the reliabil- 
ity of the individual components. 

A goal of designing the 3468A with less than 1 00 parts was set 
in the early investigation phase To design a 5te-digii DMM with 
100 parts was an aggressive goal and required a totally new 
design approach. The final 3468A has about 160 components, 
still a remarkable achievement' 

Another objective that originated in the definition phase was to 
increase the use of automatic production steps and hence reduce 
the manual labor content in the product. However minimizing the 
amount of labor is not universally the right thing to do. For exam- 
ple, machine-msertable components are sometimes more ex- 
pensive than their manually inserted equivalents. In such cases, a 
careful analysis was done to select the most cost-effective com- 
ponent, taking into account the cost of Eabor, loading errors, and 
product reliability 

With the goals of minimizing part count and labor in mind, a 
closer look at the infernal definition will reveal how these goals 
were met while simultaneously providing performance and relia- 
bility benefits to the user. 

While a conventional multimeter design incorporates at least 
two microprocessors, by using clever algorithm partitioning and 
an interrupt-driven structure, it was found that a single micro- 
processor design would meet the 346BA performance require- 
ments. A reduction m parts count, complexity, power consump- 
tion, and cost, and an increase in reliability are direct results. 



The 3468A makes extensive use of custom hybrid circuits. Both 
the analog-to-digital hybrid and the input hybrid incorporate 
high- voltage CMOS ICs and precision integrated resistor net- 
works to do signal switching and conditioning, logic decoding 
and measurement timing, The (Cs reduce circuit complexity 
(parts count) and increase the multimeter's performance by using 
the matching and temperature tracking properties inherent in 
adjacent devices on the ICs. 

One of the biggest decisions made in the definition phase was 
to design the 3468A without any manual adjustments. Instead, 
calibration is done electronically Not only does this feature 
greatly reduce the parts count and assembfy costs by eliminating 
hand-loaded potentiom enters and associated circuitry, it en- 
hances reliability and reduces drift caused by mechanical and 
thermal shock. Production-line labor is reduced by designing the 
instrument to be calibrated automatically under computer control 
via the HP-IL. And equally important, the user benefits by having 
front-panel calibration a variable. 

A liquid crystal display (LCD) was chosen for the 3468A, primar- 
ily for its pleasant appearance, readability and alphanumeric 
capability. However, it also meeis the product definition criteria by 
reducing the number of parts and assembly labor. An equivalent 
display using light-emitting diodes (LEDs) would need 31 more 
components than the LCD, all of which would require manual 
insertion into a printed circuit board, Furthermore, the LED display 
would consume more power (about 1.5W) than the LCD. 

A one-piece, silicone-rubber keyboard was selected over a 
conventional keyboard array of individual, manually loaded keys. 
Not only does this silicone-rubber keyboard eliminate 23 parts, it 
provides an easy-to-actuate switch that also forms a gasket seal 
with the front panel. Keeping dust and moisture out of the internal 
circuitry. 

One Final technology developed to meet the definition phase 
objectives is a custom printed circuit board process designed to 
maintain high impedances under all specified environmental 
conditions. This process eliminates the need for labor-intensive 
Teflon™ standoffs and allows direct automatic insertion of com- 
ponents in the printed circuit board. 

Design Phase 

In addition to striving to meet the objectives set in the definition 
phase, the laboratory project engineers added another goaf in the 
design phase of creating a "perfect" design. What was meant by 
"perfect" was a design that not only met all its instrument specifi- 
cations, but also was designed with components that were com- 
pletely characterized, specified, and guaranteed to operate 
properly under the worst-case tolerance conditions, 

To achieve this "perfect" design goal, the team placed signifi- 
cant emphasis on extensive testing of the early prototypes. Com- 
plete environmental, safety, abuse, margin, and accelerated life 
tests were run with the intention of wringing out all design prob- 
lems as early as possible, When the prototypes were not being 
evaluated by engineers, they were placed in an oven at 65^ and 
operated In all possible modes in an attempt to induce failure. 
Periodically, the instruments were removed from the ovens and 
vibrated on a shake table to try to uncover sensitivities to mechan- 
ical shock and vibration. All failures and anomalies were carefully 
documented, and with the help of the quality assurance depart- 
ment and its component analysis group, an attempt was made to 
autopsy all failed components and throughly understand every 
problem uncovered, 

A large amount of data was collected on instruments that were 
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-?rrvffDnmemai tests, Tftese units were subjected 
to temperatures ranging from -40 C C to +75*C and r« 
humidities up to 95% at 4CFC .The e&e various 

conditions was r analyzed and compared aga r 

theoretical specifications 

were tJxtfoiignjy understood 

An innovative feature of the 3468A design phase w r lien proved 
crucis 3 the quality goals, was the full-time assig 

of a materials engineer to the project This mdwiOuai s job was to 
understand the design requirements of every purchased compo- 
nent thoroughly and use that knowledge to select the best vendor 
The materials engineer discussed the expectation of perfect 
components with each vendor and then worked wfth the ve 
establish methods for achieving this goal Overall, the response 
on the part of the vendors has been quite favorable, and work 
continues to further improve vendor relationships. 

A final departure from the conventional design sequence was 
the early involvement on the part of manufacturing engineering, 
The team of manufacturing engineers established their own de- 
partment objectives to meet the overall product goals. These 
objectives were to ensure that 100% good parts were delivered on 
time to the production line, and that the product went through an 
error-free manufacturing process. Given that a production cycle 
begins with 100% good pans, and no defects are int reduced 
through the manufacturing process, it can be expected that ail of 
the instruments will turn on and function properly without any 
intermediate testing. This is the goal of the 3468A manufacturing 
team, which represents a significant departure from conventional 
manufacturing philosophy, 

To achieve their goals, the manufacturing engineers played an 
active role in working with the design engineers to maximize the 
producibifity of the design. The design engineers consulted with 
the manufacturing engineers at each prototype phase to get 
suggestions on how to improve the producibility of the 3468A. 
Under the scrutiny of the manufacturing engineers, production- 
line workers assembled the prototypes and commented on 
assembly-related problems. These comments were complied 
and a manufacturabrlity review was held. The appropriate 



3es were fncorpo rated in the next prototypes, 
~^e goal of a perfect" production process requires the corn- 
er process steps Machinery such as 
the automatic insertion equipment an:: e-soidenng 

machine were statistically characterize : ~ to red 

through the use of control e ductive work surfaces ana 

ground straps were added to work stations Air ionizers, grounded 
soldering irons, and antistatic packaging are installed through^ 
out the manufacturing area New handling procedure 
ensure that assemblies are not inadvertently contaminated dur- 
ing fabrication. Adequate tation and training are a 
necessary pan of These changes 

The entire production process is designed with manufacturabil- 
ity in mind. All intermediate tests and repair loops are eliminated 
Instead, a single, fully automatic test and calibration system turns 
on, calibrates, and characterizes each instrument only after it is 
completely assembled. The HP- JL interface and electronic cali- 
bration of the 3468A made the design of this automatic system 
possible. Another feature is the automatic collection of data on 
each instrument, This data is analyzed on a run-by-run basis to 
look for trends or shifts in specifications. Thus the final test system 
also acts as a process monitor to detect problems as they arise in 
the production process. 

Production Phase 

With the transfer of the 3468A to production, the results of these 
efforts can finally be seen. With defect rate, turn-on rate, and 
failure rate goals firmly established, the actual results were com- 
pared against predictions. The first production run yield was 70%, 
a little short of the initial goal of 75%, However, yields have been 
steadily increasing and presently exceed 80%. The long-term 
goal of achieving a 96% Turn-on yield appears to be achievable 
Each defect that is found is fully documented and presented to a 
task force whose job it is to identify the source of the defect and 
correct the problem 

The 34 68 A experiment seems to be a success. It is being 
demonstrated that by changing design philosophies, the quality 
and manufacturability of products can be significantly improved. 



Analog Design 

The 3408A , s precision analog sections are dominated by 
two custom hybrid circuits: a front-end signal conditioning 
hybrid and an A-to-D converter hybrid. Both consist of 
custom CMOS digital logic, low-leakage MOS switches, 
and precisian thin-film resistor networks. 

The microprocessor serially loads the front-end hybrid by 
using three port lines: clock, data and load. This data is 
transferred to a latch, which drives the MOS switches. The 
state of these switches, which include relay drivers, com- 
pletely defines the signal conditioning and varies with the 
particular function and range of the voltmeter. The preci- 
sion front-end hybrid requires one silicon chip and two 
resistor networks and is mounted on a custom high- 
impedance printed circuit board. Outside the hybrid circuit 
are the operational amplifiers that are the active compo- 
nents for the dc, ac T and ohms current sections. Four low- 
t henna I-emf relays are switched by the hybrid when high 
voltages are a possibility. An integrated rms converter 
supplies a dc signal representing the ac signal value to the 
A-to-D converter, 

The A-to-D hybrid consists of one CMOS chip and one 
resistor network mounted onto a standard 28-pin ceramic 



dual in-line package. The 3468A uses a modified Multi- 
Slope-Il algorithm- 1 for its A-to-D conversion. Five micro- 
processor lines into the hybrid determine the current to be 
su turned by the integrator, A comparator on the chip mea- 
sures the polarity of the integrator and sets a micro- 
processor inpul to I he proper sii^n value. The integrator 
operational amplifier and two reference operational 
amplifiers are located off the chip, 
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Low-Cost and Portability Come to Data 
Acquisition/Control Products 

inexpensive, portable data logging with the flexibility of a 
data acquisition /control system is now within the budget of 
nearly everyone making transducer measurements. 

by James J. Ressmeyer 



THE 3421A Data Acquisitio a' Control Unit [Fig. 1), 
HP's newest low-cost data acquisition and control 
scanner, represents the first instrument of this 
type using the Hewlett-Packard interface Loop (HP-1L). 1 
Battery power and the unit's light weight allow a complete 



measurement system to be configured by adding an HP-41 
Handheld Computer, an 82161 A Digital Cassette Drive and 
an 82162A Thermal Printer/Plotter. This system (shown on 
the cover] can be easily transported and operated in the 
laboratory or field. Its low cost allows individual engineers 
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Fig. 1 , T??e HP Modei 3427^ Dara 
Acquisition fControl Unit is 
cost, battery -powered, up -to- 
thirty-channel instrument with an 
internal multimeter and counter 
designed for use on the HP~!L. 



to dedicate a system to specific measurements during the 
design or test phase of product development, and opens 
new possibilities for data acquisition applications. 

The 3421 A can be configured with up to 30 channels for 
measuring dc volts, ac volts, resistance or frequency 
through the use of three 10-channel multiplexing as- 
semblies. These assemblies are directly connected to a 5%* 
digit multimeter contained inside the 3421A, The basic 
accuracy of its analog-to-digital (A-to-DJ converter is 
0.009% +6 counts for a 5 ] --digit dc voltage measurement. 
Selectable resolution of 5'i. 4Vz> or Z l h digits can be traded 
off against measurement speed. Other assemblies are avail- 
able for sensing and setting digital information, switching 
high-level [250Vrms] devices, and for designing custom 
circuits to interface directly with the instrument, Up to 
three assemblies can be used in each 3421A mainframe, 

An important feature is the instrument's ability to operate 
on battery power. A lead-acid battery inside the instrument 
■fit fully charged during normal operation fin ac line 
power. Should ac line power be interrupted to the unit, the 
battery will supply power for continued operation. The 
3421A can also be used in the field away from ac line power, 
its battery eliminating the need and expense of a portable 
generator, The Instrument responds to the HP-fL standby 
i OHUliand which puts the instrument into a sleep mode to 
conserve battery power. The 3421 A can operate up to two 
months in the sleep mode, waking up occasionally In take 
measurements, or up to twelve hours continuously on ttfi 
internal battery, 

The design objectives for the 3421 A were focused on 
providing transducer-based measurement capability with 
low COstj hjw power and battery backup, portability, and 
easn of use. 

HP offers data acquisition systems based on desktop 
computers capable of handling a very large number of mea- 
surement points. However, until the 3421 A, no similar sys- 
tem existed that could take full advantage of the new r serial 
HP4L and the low-cost controllers made available by it 

Key Features 

The function and feature sets of the 3421 A allow most of 
thetransdui it- based measurements needed in data acquisi- 
tion and logging. Many transducers, such as ther- 
mocouples, have dc voltage outputs, The 34 21 A has the 
same 300,000-COUnl autoranging A-to-D converter used in 
the 3468 A and 'M7BA voltmeters [see article on page 3) The 



lowest range has the l-j^Y sensitivity required for ther- 
mocouple measurements. The highest range allows a 
maximum input of 300 volts, giving the 3421 A a wide 
dynamic input range. A temperature sensor on each 10- 
r hannel multiplexer card provides a reference junction for 
thermocouple-based temperature measurements. The 
type-T thermocouple conversion in the 342 1A provides 
temperature readings directly in degrees Celsius. 

The 3421A also performs resistance measurements, use- 
ful in the measurement of other types of transducers, such 
as RTDs (resistance-temperature detectors) and thermis- 
tors. The lowest range has a sensitivity of 1 mfl and the 
highest range has a maximum input of 30 megohms. The 
multiplexer cards can be configured for either two- or 
liiir-wire resistance measurements. An internal zero- 
crossing counter allows frequency measurements [up to 10 
kHz), useful lor transducers with pulse outputs, such as 
flowmeters. Another function in the 3421 A is an average- 
responding ac converter for measuring line-related and ac 
signals of frequencies up to 1.5 kHz. 

All of the functions and ranges of the 3421 A are elen i 
ically calibrated by the same technique used in the 3468A 
(see page 5). A nonvolatile CMOS RAM powered by a 
lithium battery is used to store all of the constants obtained 
d ii ring calibration of the instrument. There are separate 
constants for offset correction of each of the reference- 
i mid ion temperature sensors, The calibration RAM is pro- 
tected from accidental alteration by requiring a hardware- 
enable switch on the back panel (see Fig. 2] to be set for 
calibration. The calibration constants can also be read or 
written to by an HP-IL controller through the instrument's 
I/O interface. 

I hi i42 1 A can be programmed to scan a sequence of up 
to 30 channels. The instrument has enough internal mem- 
ory to store one scan sequence program and one set of 
readings. One trigger command will take readings per the 
specified scan sequence and store them. By using the scan 
commands, a set of readings an be taken, stored, and later 
read back into the controller- In this manner, UO time is not 
required between each reading. 

TIih scanner/multiplexer capability of the 3421A resides 
OB up lo three optional printed circuit hoards accessible 
through removable covers on the rear panel. Each board 
comes with removable printed circuit board edge connec- 
tors for convenient termination of the user's field wiring. 
Terminal ions may be made permanent by purchasing extra 
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Fig, 2. Back panel of the 3421 A. 

The three Blots can be used to in- 
sert 10-channei latching-relay 
cards, digital I/O cards r or bread- 
board cards customized by the 
user for specific applications. This 
3421 A also has the optional HP-IB 
interface 



terminal blocks. 

Three different plug-in assembly options exist, any a 
which can be placed in any or all of the three slots. These 
include the lG-channel relay multiplexer/actuator a digital 
I/O interface, and a breadboard option. 

Multiplexer/Actuator Assemblies 

Each 10-channel multiplexer/actuator board contains ten 
latching, low-thermal-dissipation, armature relays giving 
the 3421 A a maximum capacity of thirty relays when three 
boards are installed- Latching relays were chosen because 
of the small drain on the battery and their inherently low 
thermal dissipation. The ten relays can be configured by 
jumpers in a number of ways to suit the needs of the user. 
Two of the relays can be used as either two-ampere ac- 
tuators or multiplexer relays, The other eight are always 
multiplexers, but series and/or shunt elements can be added 
to them. One channel comes with a removable 10:1 divider 
intended for use in monitoring power-line voltage, using 
the 342lA's internal 30Vac range. The board also can be 
jumper-selected to multiplex the sense terminals for four- 
wire resistance measurements. The HI and LO front-panel 
terminals are connected to the multiplexer's common bus. 
This bus can be disconnected from the 3421A's internal 
multimeter to use external instruments or to allow r single- 
ended scanning of up to 56 points with a common ground. 

Digital I/O Assembly 

The digital I/O board has eight floating inputs and eight 
floating outputs, The inputs are protected by optoisolators. 
Because each input can detect the presence or absence of 
current flowing, either 5 -volt TTL or 24- volt CMOS signals 
will trigger the input equally well. Each bit can be read 
individually, or the eight bits can be read as one word, The 
3421 A can be set up to trigger a multiplexer board scan 
sequence vvhen a specific digital word occurs at the inputs 
of a digital I/O board. The outputs of the digital I/O board are 
protected against shorting and use isolated DMOS FET 
switches. An on switch is capable of sinking up to 300 mA 
at less than tw r o ohms. An off switch has an impedance 
greater than 10 MQ. These switches are used as open-drain 
outputs. Each swatch can be written to individually or all 
eight can be written to as one word. 

Breadboard Option 

The breadboard option has circuitry for decoding the 



instrument's backplane and an area for the user to add 
custom circuitry, For example, this card could be confi- 
gured as a multiple-channel, continuously sampling to- 
talizer card to monitor a few channels of pulsed outputs. 

HP-IB Option 

To fit into more traditional instrumentation systems T the 
3421 A has an optional HP-IB (IEEE 488) interface, The 
HP-IB option does an internal conversion to the HP-IL. The 
internal HP-IL interface is used for isolation between the 
HP-IB and the user's measurement potential. A pushbutton 
on the rear panel (see Fig. 2} Is used to select between HP-IL 
and HP- IB operation, 

Low-Cost Design 

Keeping the cost low while keeping the capabilities high 
was a major goal for the design team. One of the largest cost 
savings is realized through the mechanical packaging. 
Since the instrument is intended to be Jow-pow^er and 
lightweight, plastic packaging fits the definition perfectly. 
The package is a tw^o-piece full-rack- wddth clamshell with 
separate plastic front and rear panels. 

The 3421A is designed to be used with a controller, so it 
was not necessary to include costly front-panel controls for 
manual operation. Front-panel-emulation programs for 
user convenience in setting up data acquisition applica- 
tions are available for both the HP-85 Personal Computer 
and the HP- 41 Handheld Computers. The programming for 
the HP-41 is achieved by adding a special ROM and 
keyboard overlays (see article on page 16], For use with the 
HP-85, the 305 6DL system was developed (see box on page 
13), 

The block diagram of the 3421 A (Fig. 3] illustrates other 
cost savings. Since most pulse output transducers do not 
use frequencies higher than 10 kHz, and ac voltage mea- 
surement at other than line frequencies is normally not 
done in data acquisition, the dc front end can also be used 
for both ac voltage and frequency counter measurements. 
All the protection and signal amplitude conditioning al- 
ready exist in the dc front end, The additional circuitry 
required for ac measurements and the counter is minimal. 
The 3421 A 's microprocessor accumulates the pulses for the 
counter 

Another major area of cost savings is in the pow ? er 
supplies. Portability, and therefore battery power. w T as one 
of the major design goals. By optimizing the power 
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Data Acquisition and Control Software for the 3421 A Using the 

HP-85 Computer 

by David F, Leonard 



To simplify the use of the 3421 A Data A: 
for data logging applications, the 3056DL System is available 
One or two 342" - HP-85 Personal Computer to control 

them are housed in one cabinet (Rg 1 ) and supplied with an 
appropriate package of software routines 

Most dedicated data loggers are self-contained units with the 
analog front end and the digital user interface portion housed in 
one box. Because of the low cost and flexibility of both the 3421 A 
and the HP-85, the total 3056DL system is comparable in price to 
that of most single-box data Joggers and js more versatile. The 
3056DL software has been written to make the system easy to use 
for the person who is not familiar with computers or instrumenta- 
tion. Thus, a user can take advantage of the flexibility of the 
computer without paying the price of the long startup times for 
which computer-based data acquisition systems have been 
known. 

The 3056DL software package includes a data logger routine, a 
program that emulates an instrument front panel instrument 
diagnostic programs, and graphics programs to plot data from 
the data Jogging results. Subprograms that linearize temperature 
transd ucers are also available on the tape for the user who needs 
to write a more specialized program, 

Data Logging Setup 

The data logger setup is divided into two major parts: channel 
setup and timing setup. A setup is done for up to 20 groups. A 
group is defined as a group of channels with the same label, 
function, data conversion equation, and limits. 

A label can be up to 26 characters long. The function can be 




t 



Fig, 1. A powerful, compact* yet low-cost data acquisition 

system, the HP 3056DL, ts formed by combining one or more 
3421 As with an HPS5 Computer 
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Fig. 2. Limn display for the 3Q56DL system. 



one of the following: 

■ dc volts 

■ ac volts 

■ Ohms (two or four wire) 

• Frequency 

i Thermistor temperature measurement 

■ RTD temperature measurement 

■ Thermocouple lype J,K,T.E,R, orS temperature measurement 

■ Digital input 

• 4-to-20-mA input 

« Close or open an actuator or digital channel. 

Data conversion software will convert inputs according to linear 
or fifth-order polynomial equations, or for greater flexibility, the 
data Jogger will call a subprogram (the name of which is entered 
during setup) at the time data conversion is done. The user writes 
the subprogram and stores it on the software tape. Unrts for the 
converted data can be specified These units can be up to five 
characters long. 

Limits are used to initiate an action when a reading or converted 
reading reaches a value specified by the user. Limits can be one 
of three types; high. low. or delta. The action will be initiated when 



GROUP NUMBER I 

LABEL FURNACE TEMPERATURE 

FIRST CHANNEL 

LAST CHANNEL 19 

FUNCTION = THERMOCOUPLE-^ 

CONVERSION TYPE: NONE 

l imit* i t-ou mm 



LIMIT* 2 HTGH 1339 
LIMIT* 3 NONE 
LIMIT* 4 NONE 
LIMIT* 5 NONE 



C lear 
EDIT 






I 



DONE I \W 

Fig, 3, Channel setup display for the 3056DL system. 



FEBRUARY 1983 HEWLETT-PACKARD JOURNAL 13 



)Copr. 1949-1998 Hewlett-Packard Co. 



CHANNEL 5 

FUNCTION TC-R De* C 

RERDING 3S.89 



RESET CHANNEL DIGITAL 
FUNCTION FORWARD REVERSE 



done 
CUD 



Fig. 4. Basic front-panef display on the HP-85 Computer for 
the 3056DL system. 

a high limit is exceeded, the reading is less than a low limit, or a 
reading exceeds the last reading for that channel by a specified 
amount (delta limit). The limit actions are indicated on the HP-85's 
display as shown in Fig. 2. Up io five limits can be specified per 
group. 

Fig. 3 shows the channel setup display. Specifications for the 
channel setup are entered by moving the line (shown under limit 
#1 in Fig. 3) to the line that is to be changed. The Itne is moved up 
and down by pressing the soft keys labelea by arrows. When the 
EDIT key is pressed, the dispiay instructs the user on what entries 
can be made, usually by relabeling the softkeys. After the entry is 
made, the CRT returns to the original display, which then shows 
the entry just made. 

Once the channel setup is complete, the timing setup for each 
group is done. The timing setup specifies whether or not the group 
of channels is to be scanned at specified intervals or at a time of 
day f the number of times the group is to be scanned, and finally 
how the resulting data is to be handled. Data can be stored on 
tape, displayed on the HP-85's CRT, or printed on its printer. 

Front -Pa net Emulator 

The basic front-panel display is shown in Fig. 4. The first tine 
shows the acquisition channel that is closed. The function is 
shown on the second line. The third line shows the last reading 
read from the 3421 A. The shaded rectangle, shown to the right of 
the reading, blinks when a new reading is displayed. 
m When the FORWARD or REVERSE softkey is pressed, the 3421 A 

will step forward or backward throug h the acquisition channels. 



HHflHNEL I 26 \ 2 1 I 22 I 25 i 24 \ ?* : ??. ? - 

input i i ; i : l i ft s i t i ; i ; 3 ; 

DECIMFIL VRLUE OF INPUT IS 119 



Kl-VIEW NEXT DIGITAL CfiRD 
K2-0UTPUT TO DIGITAL CARD 
> 4-PETURN TO FRONT PBHEL MENU 



NEXT 



OUTPUT 



RETURN 



Fig. 5, Digital card display tor the 3Q56DL system. 

The reading shown will then reflect the input on the new channel 

chosen, 
i The Channel softkey allows the user to close or open an 

acquisition, actuator, or digital channel. 
, When the function softkey is pressed, the user can change 

the function to one of the fifteen available. 
r The CMD softkey is used for output! ing an ASCII command to 

the 342] A. 
f When the DIGITAL softkey is pressed and a digital card is 

present in the 3421 A, the display shown in Fig. 5 appears. Here 

the display shows the eight-bit input of a digital card in slot 2. 

When the OUTPUT softkey is pressed, the display prompts the 

user for a decimal number to be output to the digital card P and 

the 3421 A's liquid-crystal display shows the value of the digital 

outputs. 
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Fig. 3. Block diagram of the 3421 A, 
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Table I 
3421 A Instruction Set 

Standard Instruction Set: 

OCV dc volte [channel list] 

ACV ac volts [chanael listj 

TWO Two- wire ohms [channel list] 

FWO Four- wire ohms [channel list] 

TEM Temperature [channel list] 

FRQ Frequency [channel list] 

TOT Totalize [channel number] 

REF Reference junction temperature [channel number] 

CLS Close a single channel or digital bit j channel number) 

CLP Close a pair of scanner channels (channel number) 

OPM Open a channel or digital bit [channel number] 

WRT Write a digital byte < slot number, decimal value 0-255} 

RED Read a digital byte (slot number) 

Bn" Read a digital bit ', bit list) 

Advanced Instruction Set: 

RS Reset 

F Function {function number) 

R Range (range exponent) 

RA Range auto (l if on, if off) 

G Gate time {second exponent) 

N Number of digits of resolution {3,4, or 5} 

T Trigger mode {number) 

Z Autozero {0 if off, 1 if on) 

C Calibrate [cal value 

SR Status registers 

ON Display number [number 0-29] 

Dl Display digital inputs 

DO Display digital outputs 

M SRQ mask [number] 

DT Digital trigger {digital channel) 

Rl Read channel list 

LS Load single scanner channels into list {channel list} 

LP Load pairs of scanner channels into list (channel list) 

SI Scanner increment {O or l) 

UC Unconditional close (channel number) 

MH Monitor high (digital bii 

ML Monitor low {digital bit) 

AN AND mask [decimal value 0-255] 

XR XOR mask [decimal value 0-255] 

mn Monitor {slut number), used with AN and XR 

DS Digital set (slot number, decimal value 0-25$) 

DC Digital dear (slot number, decimal value 0-255) 

CAL Calibration RAM (l if read, 2 if write) 

] if optional 

{ ) if not optional 



supplies, knowing that a battery will be always present, a 
significant savings is realized over traditional battery op- 
tions in other instruments that use more expensive center- 
tapped transformers and linear regulators for direct ac op- 
eration in addition to battery-powered supplies like those 
used in the 3421A. 



Instrument Friendliness 

Our ability to use instruments in systems has taken gigan- 
tic steps since tlie fixst programmable instrumentation was 
introduced in the 1 960s, We feel that because of its low cost 
and high capability, the 3 ■ 1 find its way into the 

hands of some less electronically sophisticated users. 
Therefore, we made it easy to program, The first major 
hurdle in programming most instruments is remembering 
to write to the instrument everything it needs to know to 
complete the task, The 342 1 A 1 s standard instruction set (see 
Table I) includes most of the normal measurement tasks 
made by an instrument of this type. By sending it just one 
simple command, every thing is handled by the instrument 
to complete the entire task. For example, to measure dc 
voltages on channels 2, 3, 4, and 8, the user merely sends 
DCV2-4.B or DCV2,3 f 43,r If this instruction is compared to 
those for earlier instruments capable of making the same set 
of measurements, it can be seen that the 3421 A is much 
easier to use. The 3421 A also contains more traditional 
instructions which we have chosen to call the advanced 
instruction set. To take the same set of readings using the 
advanced instructions, the following commands are sent to 
the 3421 A: 

LS2 T 3,4,fl [Loads scanner list] 

F1RA1 Z1N5T3 [Configures 3421 A; Fl =dc volts, RA1 ^auto- 
range. Zi=autozero. N5=5 digits* T3=trig- 
ger through scanner list) 

Besides the software programs available for the HP- 41 
and HP-85 controllers* other features include an internal 
type-T thermocouple conversion. Thermocouple mea- 
surement with the 3421 A is easily accomplished by con- 
necting the thermocouple to the appropriate channel and 
sending TEM(channel number). The measurement reads the 
temperature of the reference junction and the voltage across 
the thermocouple. A software compensation is performed 
on these readings to give the corrected temperature* A test 
of friendliness devised early in the definition phase of the 
project centered around how easily a temperature mea- 
surement could be made using a thermocouple. For most 
instruments, it is a complicated task. However, with the 
3421 A, all the work is dune for the user, 

Low-Power Operation 

To do a good job at remote data logging and to make full 
use of the battery, low-power design techniques are used 
throughout the instrument* One of the major power savings 
is realized through the use of latching relays in both the 
A-to-D front end and in the multiplexer- Each relay is mag- 
netically latched either on or off; all that is required to set or 
reset a relay is a 10-ms current pulse through the appro- 
priate winding. An additional advantage of these relays is 
the low thermal voltage offsets because of the lack of power 
dissipation. 

Another major contributor to keeping the power con- 
sumption low is the power supply design. The ac line input 
charges the battery, and the ±15-volt supplies are derived 
using an efficient switching technique, The 5- volt supply is 
linearly regulated directly from the battery. The liquid- 
crystal display and extensive use of CMOS logic also con- 
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tribute to reducing power consumption. 

Implementation of the HP-IL power- down mode provides 
the user with greatly increased battery life. In this sleep 
mode, only a small fraction of tbe circuit is kept powered 
up. At times specified by the user, the HF-1L system can 
wake up and perform its function. For example* in continu- 
ous operation, the battery life of the 342 lA is specified at 
twelve hours minimum. Use of the HP-IL power-down 
function extends the battery lifetime, allowing the user to 
take a set of thirty readings once an hour for a period of more 
than one month. Since the HP-41 P the 82162A Printer, and 
the 82161 A Cassette Drive also implement the power-down 
function, a powerful battery-powered system, which can be 
controlled by the 82182A Time Module (which plugs into 
the HP-41), can be assembled for unattended data logging. 
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Low-Cost Instrument Control: A New ROM 
for the HP-41 Handheld Computers 



by David L. Woipert 



HP'S NEW SERIAL INTERFACE LOOP [HP-IL] and 
82160A HP-IL Module make it possible for an HP- 
41 user to control instruments such as the 3468A 
Multimeter and 342 1A Data Acquisition/Control Unit, thus 
forming low-cost measurement systems for bench or field 
applications. To reduce the amount of programming and 
simplify use. a custom ROM and keyboard overlays (Fig. 1] 
are available for HP-41 users. The HP 44468 A Data Acquisi- 
tion and Control Package (DA'CPac) is based on the instruc- 
tion set for the 3421 A. Each of these instructions performs a 
complete measurement task or a complete operation. 

To illustrate the capability and friendliness provided by 
the 44468A DA/C Pac ROM, consider the measurement of ac 
voltage by a 34 68 A Multimeter on the loop. Even without 
DA/C Pac ROM, this can be done bv a fairly simple program 
for the HP-41: 



Oi*LBL "ME-AS2" 




i468A" 


03 


FINDID 


04 


SELECT 


05 


n F2NbRA21T^" 


06 


OUTA 



07 

08 



INI) 
END 



The above program finds the voltmeter's address on the 
loop* selects it, sets function, range and trigger, and takes a 
reading- But if there is no 3468A on the loop T there will be 
an address error at step 04 (ADR ERR) , and if a syntax error is 
noted by the 3 468 A, step 07 may produce a TRANSMIT ERR. 
To trap most of these likely errors, a more complex program 
is necessary. The following example handles most foreseen 
anomalies, and responds with friendly prompts on the HP- 
41 T s display such as NO INST (no such instrument found) 
and FN ST ERR (instrument error). 



G1*LBL "ALU" 
2 "HP3421A". 

03 FIND ID 

04 X^0? 

05 GTO *Ffc6" 

06 SELECT 

07 W ACU' 

08 OUTA 

09 INSTA1. 



First look for a 3421 A. The ROM ac- 
tually looks for a measurement de- 
vice, using accessory poll. 



Telia the Interface which device to 

talk, listen to 



This is the standard 3-521 A Instruc- 
tion tor measuring ac voltage. 



Read Instrument status byte. 
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10 FS? 

11 GTO 

12 IND 

13 RET 

14*LBL 

16 FINDI0 

17 > 

1? SELECT 

20 "F2N5RA/1T2 

21 OUTA 

22 1 

23 RET 
24*LBL N ER1" 



25 
26 
27 
28 
29 
30 
31 
32 



"NO INST" 

AVIEW 

STOP 

*LBL 

"INST 

AVIEW 

STOP 

END 



ER2" 
ERROR 14 - 



Errof occurred if flag 5as«in status 
byfe 

Gel the raedlng- 



Hq standard instruction set instru- 
ment was found, look for a 3*68*. 



, This Is the 3*66 A instruction string 
for a single sc voltage reeding. 



Gel the readmg. 



3421 A or 3468A not found— cannot 
measure ac voUage 



Syntax or caiibralton or other error. 



By contrast, the 44468A DAv'C PAG ROM reduces this pro- 
gram to three simple lines: 

U1*LBL "HEA 
2 AC 

■ END 
This trivial program returns an ac voltage to the HP-41 T s 
X register, and handles all the commands that are necessary 
for using the 3421A or 3468A. 



DA/C Pac ROM 

The custom ROM is divided into seven basic parts: 

■ Microcode for friendly operation of instruments. This 
males it easy to use the automatic addressing features of 
the HP-41 and HP-IL. Included are some basic instrument 
operations for digital multimeters, scanners, and combi- 
nation devices such as the 3421 A. These include MEA- 
SURE dc VOLTAGE. CLOSE CHANNEL, et cetera. 

■ Microcode for polynomial (and other] expansions of 
temperature functions. This makes the HP-41 signifi- 
cantly faster in performing temperature conversions, a 
typical user task for the 3421 A and other instrument 
systems. Conversion functions for thermocouples 
[TJ.R.E.K, and S types), thermistors [2252 or 5000 ohms 
at Z5 C C), and platinum resistance- temperature detectors 
[RTD, 100 ohms at 0*C) are included, with software cold- 
junction compensation for the thermocouples. 

■ User code for complete temperature measurements, 
including cold-junction measurement and software 
compensation. 

■ A data logger application program. This simple data ac- 
quisition program can print or store on an 82161 A Digital 
Cassette Drive the data from up to 30 channels of inputs 
of various kinds (voltage, resistance, temperature, fre- 
quency) taken at time intervals specified by the user 
during setup. 

* Front-panel program to allow the HP-41 to manipulate 
the 342 1A. acting as its front panel. 

• Miscellaneous routines which include an alarm setup 
program (prompting), a routine to find an instrument. 
DVM or scanner on the HP-IL, a routine to output a 
command to an instrument, and a decode routine to re- 
turn measurement functions and units to the data logger, 




Fig, 1. The 44468 A Data Acqui- 
sition iControt Package ROM 
comes with overlays for the HP- 4 1 
keyboard to simplify HP- it mea- 
surement system programming. 



FEBRUARY 1SS3 HEWLETT-PACKARD JOURNAL 17 



)Copr. 1949-1998 Hewlett-Packard Co. 



■ Miscellaneous microcode for easy programming* such as 
a key assignment routine and programmable timer alarm 
clearing. 

Because there are certain things that cannot be done by 
the standard HP-41 instruction set, the DA/C Pac ROM ex- 
tends the instruction set by microcode to use the Accessory 
ID provisions of the HP-il,< Also, the thermocouple; 
therm istor/RTD conversions are written In microcode. Al- 
though these could have been done with standard HP-41 
instructions, the microcode executes much faster and does 
not require the use of the stack or other registers* Below is a 
listing of some microcode routines in the measurement 
portion of the DA/C Pac ROM: 

DCV Measure dc voltage 

ACV Measure ac voltage 

TWO Measure resistance (two-wire) 

FWO Measure resistance (four- wire] 

These four commands differ only in the string that is sent to 
the measurement device. The command flow is as follows, 
where (cr J indicates a carriage return and [If] indicates a line 
feed operation. 

1. Search for measurement device (detector) 

A. If instrument type 51 (e.g.. 3421A) is found: 

a. Address device to listen 

b. DCV; send "HCV [cr) (if)'* 
ACV: send "ACV (cr) jltf 
TWO; send "TWO [crj (If]" 
FWO: send "FWO [cr} (If)" 

B. If 3469A is foimd: 

a. Address device to listen 

b. DCV: send "F1N5RAZ1T2 (cr) [If)" 
ACV: send "F2N5RAZ1T2 (cr) [lf) M 
TWO: send "F3N5RAZ1T2 [cr] (if)" 
FWO: send "F4N5RAZ1T2 [cr] (If) TP 

C. If instruments are not found: 

a. Display "NOINST" 

b. Return 

2. Get device status byte 
A. If bit 5 is set: 

a. Display "INST ERR" 

b. Return 

EL If bit 5 is clear. 

a. Input device data to X register 

b. Return 

Some examples of the mathematical routines available in 
the DA/C Pac ROM are listed in Table I 

The 3421A front-panel program is another part of the 
DA/C Pac ROM; it makes it very easy to set up and test a 
3421 A. It prompts the user when numeric input is required 
and uses standard instructions to address the 3 421 A, For 
example, the user can connect the HP-IL cables, turn on the 
3421 A and the HP-41, and execute the following. 

HP-41 Keys Display Comment 

Xeq, Alpha, F f The HP-41 will find and 

P, Alpha select the 3421 A on the 

HP-IL and reset it. 



DCV This is the 2+ key if the 

DA/C Pac ROM overlay 

[Fig* 1] is not in place. 

Channel? The HP-41 prompts the 

user for a channel number. 
The user would then 
put in the channel number 
and press R/S + or press R/S 
alone to measure the current 
channel or at the front- 
panel terminals, 

2, R/S The user has selected 

channel 2, 
3.00102 oo The reading from channel 
2 is Hashed on the display 
repeatedly. 

FOR The user wishes to advance 

to the next channel (the SST 
key without the overlay). 
-3.00105 00 The reading from channel 3 
is flashed on the display 
repeatedly. 

When an error occurs, caused by selecting a channel that 
is not present or an invalid function for the current channel, 
the calculator beeps and displays dashes to indicate that no 
reading is available. 



Table I 
Example DA/C Pac ROM Mathematical Routines 

Command Function 

OF °C to °F conversion 

X' - 1.8X + IS 

THM2 Ohms to *C, thermistor is 225212 at 25°C 

X r = [l/(a + b InX + c(lnX) 3 ]] -273.15 
where a = L470S73889E-3 
h - 2.3779O5230E-4 
c - 1.032577937E-7 

THM5 Ohms to °C. thermistor is 5000ft at 25°C 

X' = [l/(a+blnX + c(lnX) 3 l]-273.15 
where a = 1.285496378E-3 
b = 2.3G0998857E-4 
c = 9.324409398E-8 

RTD Ohms to °C. RTD is 1Q0H at C C 

If X<100: 

X' - a + bXllO 2 + cX 2 ,no 4 + dXP/10? 
where a - -241.9967592 
b = 222.5606179 
c = 25.24882388 
d = -5.812682625 
I! \=M00: 
X' = a - V b - c.X 100 
where a = 3367.821441 
b = 13.065.7H4.86 
c = -1J23.543.606 
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HP 3421P 


DOTfl LOGGER 








KV 






Wf 


PRINT 




F/12/82 2-ee PM 


. 9576E-3 DCV 


. 9*S9«E-3 DCV 


23: 34.3388E-2 ftCV 


24; 35.1««E-3 BCV 


25: 35. 1888E-3 ftCV 


4: 7.745«8£-3 DCV 


5: -%.65H8t-3 DCV 


PAS; 


2:15 PH 


2: Z32.888E-3 DCV 


3 154.632E-3 DCV 


31.8BME-3 flCV 


24 31.8S88E-3 ftCV 


25 31.7888E-3 fiCV 


4 &.7528E-3 DCV 


5: -8.97188E-3 DCV 



Fig. 2. Typical data fogging printout using the 44468A QAiC 
Pac in an HP-41CV Handheld Computer controlling a 3421 A 
Data Acquisition f Control Unit and an 821 62 A Printer Program 
records dc voltages on channels 2 and 3, ac voltages on 
channels 23>24 t and 25, and dc voltages on channels 4 and 5 
during each periodic scan sequence. The values recorded for 
two scans are shown. 

The data logger program is also very simple to use, yet has 
some powerful capabilities not usually found in such a 
small system- The user is guided through a setup in which 
the user can select channel groups and assign various func- 
tions to these groups. Functions available include six ther- 
mocouple types, dc and ac voltage, two- and four-wire 
resistance, RTD and thermistor measurements, frequency, 
user- written routines, actuator control, and digital outputs. 
The user is prompted In find out whether the readings are to 
be recorded on the #21 61 A Digital Cassette Drive or printed 
on the 82162A Thermal Printer, Next the user is asked to 
select a start time, a time interval for the measurements, and 
the number of scans to be done, Between each scan of the 



channels* a loop power- down command (FWRDN) is used to 
conserve batten- I ife, in case of a system which is operated 
away from ac line power. At the proper time, the HP-41 and 
the HP-IL devices are powered up and a measurement cycle 
is performed, with the results being printed audio r recorded 
as specified by the user before the system is powered down 
to await the next scan. Fig. 2 shows a typical data logging 
printout. 

Fig. 3 illustrates the use of the 44 468 A DA/C Pac ROM 
in an HP-41 to control a 3468 A Multimeter for dc voltage 
measurements in the field. 




Fig. 3. Measuring electrical parameters in the field is now 
much easier using a 3468 A Multimeter . an HP -4 1 Handheld 
Computer, and the 44468A DAtC Pac ROM. 
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Electronic Mail for the Interactive Office 

Here's how electronic mail is implemented on the HP 3000 
Computer System. HPMAIL lets users who aren't familiar 
with computer technology exchange messages effectively 
within their organization. 

by lan J. Fuller 



HPMAIL IS AN ELECTRONIC MAIL SYSTEM that 
operates on the Hewlett-Packard 3000 Computer Sys- 
tem, It is designed to enable users who may not be 
familiar with computers and their associated technology to 
interchange information effectively throughout their or- 
ganization. With HPMAIL, messages, documents, business 
charts and graphs, and HP 3000 system files can be ex- 
changed both locally and remotely. 

HPMAIL operates concurrently with other data- 
processing and office information- processing activities, It 
operates from any terminal that can be connected to an HP 
3000, That includes the HP 2B26W Word Processing Sta- 
tion, the compact HP 2 382 A Office Terminal, the HP 125 
Personal Office Computer, and any of the large range of 
other HP terminals and desktop computers with data- 
communications connections to HP 3000s. 

Using standard Hewlett-Packard Distributed Systems 
Network capabilities. HPMAIL manages all message rout- 
ing and data communications among multiple HP 3000 
Systems. A store-and-forward feature facilitates transmis- 
sion through the nodes of a multiple-system network, pro- 
viding flexible network paths through existing data- 
communications connections. These may be over dial-up. 
leased, direet-cormect or public data network (X.25 and 
X.21) lines. Users need only specify the name of the recip- 
ient. Actual routing paths are invisible to the user. A gen- 
eral delivery capability routes messages to locations where 
they can be distributed manually. 

Each user has a set of software tools that map onto the 
traditional elements of the desk. An electronic in tray keeps 
track of incoming messages, while the out tray organizes 
mail being sent. Users monitor the progress of messages in 
the pending tray. Senders can not only verify that their 
messages have arrived, but also that they have been read. A 
work area provides for composing and editing longer com- 
munications, and for assembling packages of information 
files, including graphics, A file cabinet stores messages and 
documents, A distribution directory lets the user construct, 
use and store standard distribution lists. An administration 
area provides the means to tailor the HPMAIL environment 
with passwords, autoforward instructions, autoanswer mes- 
sages, and the choice of a person to handle mail on the user's 
behalf. 

Simple commands perform everyday mail functions. 
Movement between HPMAIL areas is by function keys, au- 
tomatically labeled on the screen when that ability is sup- 
ported by the particular HP terminal. 

To reduce the on-line system storage traditionally re- 



quired by computer-based message systems, HPMAIL uses 
an HP 3000 IMAGE data base for document storage and 
local distribution Documents are stored only once on each 
system in a network with pointers for each intended recip- 
ient. 

HPMAIL Functions 

The basic facilities required of any electronic mail system 
are to accept mail, address users, store mail, sort outgoing 
mail, move the mail, sort incoming mail, deliver mail to 
recipients, and notify recipients. HPMAIL performs all 
these functions. It also tracks the progress of mail and pro- 
vides a flexible and powerful user interface. 

HPMAIL can transmit any information that can be stored 
in the HP 3000 system- This can range from a few lines of 
simple text to a complex report containing, perhaps, reports 
produced by a word processor such as HPWORD, graphics 
produced by DSG/3000 or HPDRAW. and even HP 'MHH) 
program and data files. We decided to adopt as flexible a 
structure for these items as possible, enabling the user to 
organize them into packages of logically related items. At 
the same time, we realized that the majority of HPMAIL 
messages would be simple text and made it very simple for 
this type of message to be accepted into the system. 

HPMAIL can be implemented as a multicomputer sys- 
tem, but it is important in the office environment that users 
be shielded from the details of the configuration of their 
particular network, To this end we implemented an 
addressing scheme, HPMAIL usbts are registered with the 
system In such a way that senders of messages do not need 
to know whether recipients are located on their computer or 
on one many miles away, connected through a complex 
network. It also allows the administrator of an HPMAIL 
network to reconfigure it without users having to change 
the way in which they address other users. 

The system must be able to store mail before transmis- 
sion, on intermediate computers in a store-and-forward 
network, and on the behalf of users. Because of the poten- 
tially large space requirements for messages on a system, 
HPMAIL has adopted the strategy of sharing information 
wherever possible. Thus, when a message is delivered to 
several users on the same computer, only one copy is stored 
and pointers are set up linking the message to each user's in 
tray. 

Mail in transit must be sorted into queues for transmis- 
sion to the required destination and for distribution at the 
destination computer* a process analogous to the operation 
of a sorting office in a manual mail system, This can be a 
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Fig. 1 . Major software components of HPMAIL 

time- consuming process, involving the analysis of large 
distribution lists, and so we decided to have this function 
performed by a background process called the mailroom, 

Mai i must be transported between computers as econom- 
ically as possible, HPMAIL uses the program-to- program 
(PTOP) communication facility provided by DS/3000 for 
this task. These potentially lengthy and error-prone opera- 
tions are handled by autonomous processes known as the 
transport manager and the master and slave trucks. 

Once arrived at its destination computer, mail must be 
delivered to its recipients and the recipients must be 
notified of their new mail if possible. This work is also 
handled by the rnailroom program . 

For users to have confidence in the operation of the mail 
system they must be able to track the progress of messages 
that they have sent. HPMAIL provides five acknowledg- 
ment levels that users can put on a message and the trans- 
port system keeps users informed of the progress of their 
messages according to the acknowledgment level that they 
have set. 

The HPMAIL user interface provides users with powerful 
facilities to create and stare messages on their electronic: 
desk, making HPMAIL far more than a simple message 
system. Examples of the facilities provided are the work 
area in which items may be constructed before incorporat- 
ing them in messages, the filing cabinet, in which users may 
store messages for future retrieval in folders they have 
named, and the distribution list area, where users can keep 
distribution lists of other users with whom they correspond 
for easier compilation of messages. When we designed the 
HPMAIL user interface we placed considerable stress on 
ease of use for the nontechnical user and compatibility with 
any terminal that can log on to the HP 3000. This lets users 
access their mail even when they are away from their office 
if they have a portable terminal and access to a telephone, 

Implementation of HPMAIL 

One of our principal design objectives in implementing 
HPMAIL was that the product should be easy to maintain, 
test, debug, and update. To this end we decided upon a 
layer concept for the software, with each layer communicat- 
ing via rigidly defined interfaces. This allowed develop- 
ment of the transport mechanism to proceed relatively un- 
disturbed while the details of user interface design were 
refined through a series of tests, prototypes, and evalua- 
tions. The task i>j inte^rriting these components, often a 



major headache in software projects, proved to be a rela- 
tively simple task with HPMAIL and the software has 
proved to be very robust in use- 
Fig. 1 shows the major software components of the prod- 
uct. The user interface program is responsible for all the 
user interaction in the product and provides the user with 
the electronic desk described previously. The mailroom is a 
background job streamed by the system operator and is 
charged with the sorting and delivery of local mail, that is, 
mail that is destined for users on the same computer. The 
transport manager is responsible for scheduling the com- 
munication of messages between HPMAIL computers ac- 
cording to the current message load and the availability 
schedule set up by the HPMAIL system administrator. 

The master truck is controlled by the transport manager 
and is responsible for the setup and control of the DS/3000 
connection with a remote computer where it uses the slave 
truck program to receive the mail and put it onto the remote 
data base. The clock tick generator runs as a son process of 
the transport manager and provides it with a tick every 
fifteen minutes to cause the transport manager to re- 
schedule its transmission priorities as necessary. 

The configurator is a VP.L US/3000 application program 
used by the HPMAIL system administrator to build and 
configure the HPMAIL data bases. Facilities are provided so 
that the administrator does not need to have any detailed 
knowledge of IMAGE/3000 to control HPMAIL 

The operator interface is a set of functions that enable the 
system operator to control HPMAIL and determine its 
status. Examples of operator commands provided are 
MA1LON and MAILOFF to enable and disable the system, 
MAILSTATUS to provide a status display for the system- 
MAILSHOWNODE to display the number of messages await- 
ing transmission to remote computers, and MAILMAINT to 
start the maintenance program. 

The maintenance program is run periodically to provide 
verification of the intactness of the HPMAIL data bases, to 
delete outdated mail items, and to generate statistics, which 
are formatted and printed by the report program. Regular 
running of the maintenance program is a vital part of main- 
taining a reliable HPMAIL system. 

Development Techniques 

The programs described above were developed simul- 
taneously over a period of eighteen months. For this w r orkto 
proceed reliably a set of techniques was derived before 
detailed design began. 

Three techniques we adopted in the development of the 
product deserve mention here as being important to the way 
in which the product evolved. These are the use of mail 
procedures to access the data bases, IPC or pipe files to 
communicate between the components of the product, and 
the standardized tracing and error reporting mechanism 
used throughout the product. 

Mail Procedures. The HPMAIL software is built around two 
IMAGE/3000 data bases, called LOCAL and GLOBAL, which 
are discussed in the next section. The application programs 
that access the data bases, for example the user interface, 
mailroom, transport manager and trucks, do so through a 
set of intrinsics (routines) called mail procedures - These 
mail procedures are in a segmented library and so are 



FEBRUARY T9S3 HEWLETT-PACKARD JOURNAL 21 



)Copr. 1949-1998 Hewlett-Packard Co. 



accessible to all the programs. They perform the low-level 
data base access functions and insulate the programs that 
call them from the details of the data base structure, In fact, 
the transport programs do not have a single IMAGE call in 
them; all interaction is done through mail procedures, 
Examples of the mail procedures include MOPEN to open 
the mail data bases, MCREATE to create a new item, 
MEXPLODE to return information about the contents of an 
item, for example the messages in a user's In tray. M ATTACH 
to attach one item to another, for example, to attach a new 
message to a user's in tray when delivering it, MDELETE to 
delete an item, and MCLGSE to close the mail data bases. 

Other mail procedures were implemented to perform 
common functions required by different modules, for 
example, comparing two names, In all, about thirty mail 
procedures exist in the HPMAIL segmented library 

These procedures were designed, tested, and made avail- 
ed}]'' before any coding was done on the programs that 
would use them, thereby providing a firm base upon which 
development could proceed, 

IPC Files, Besides using the two IMAGE data bases, the 
various components of HPMAIL communicate with each 
other using the interprocess communication [IPC) or pipe 
facility provided by the HP aOOO's MPE-IV operating sys- 
tem. This method of communication has the advantages of 
being very well defined and straightforward, It is reliable 
and provides an interrupt mechanism whereby a program 
can wait for a message on its pipe telling it what to do next. 
Once again, this convention aided the product implementa- 
tion. Modules were tested using simple test harnesses be- 
fore atlernpting to integrate them. 

Three IPC files are defined in HPMAIL- MRIPQN is the 
mailroom input pipe, which is written to by the user inter- 
face when a user MAELs a message, instructing the mailroom 
to collect it from the user's out tray and deal with it. It is also 
written to by the slave truck when it receives mail from a 
remote computer bound for the local computer, alerting the 
mailroom to deliver it. 

TMIPGIN is the transport manager input pipe, which is 
written to by the mailroom to inform it abnut new mail 
bound for remote computers which it should attempt to 
send, and by the clock tick process, which runs as a son of 
the transport manager and sends it a message on this pipe 
even' fifteen minutes to cause it to reschedule itself to take 
account of any change in the availability of routes out of the 
local computer, 

MTIPCIN is the master truck input pipe. The transport 
manager sends instructions, such as 'open a DS line to 



computer X r " to a master truck, which attempts to perform 
this operation and reports back to the transport manager 
on its input pipe the success or failure of the operation. The 
transport manager can support up to eight master trucks 
simultaneously and each has a separate input pipe, referred 
to as MTIPCINO, MTIPCIN 1. etc. 

Tracing and Error Reporting. Since HPMAIL consists of a 
number of intercommunicating programs and each pro- 
gram consists of a large number of modules, each separately 
compiled, it is important that status information about the 
success of each operation is returned to the caller. It is also 
important to have a trace facility built into the product so 
that errors can be traced and diagnosed with minimum 
trouble. 

In HPMAIL, a single data structure called the mail com- 
mon area is used to communicate shared data such as 
completion status, file numbers, and user information be- 
tween the various procedures in a program and with the 
mail procedures. This Is very much in line with products 
such as VPLUS/3000 or IMAGE/3000. 

Each procedure in the product (and there are over H QO ) 
takes the mail common area as its first, and sometimes only, 
parameter. The convention was established that all the pro- 
cedures call a mail procedure called MTRACE immediately 
upon entry and before exit. MTRACE registers the proce- 
dure's identity in the mail common area and can also be 
made to write a log message to a file if required. 

Error reporting is centralized in another mail procedure, 
MERROR, which interprets the status words in the mail 
common area and can produce a customized error message 
from the message catalog for each error, together w r ith as 
much additional information as can be deduced, Since all 
the trace messages are derived from the message catalog f 
they can, if necessary, be translated to other languages. 

The tracing level of these procedures can be varied by 
setting a job control word [JCW) or by passing a run-time 
parameter (PARM) to the program. Thus, when debugging a 
program, the engineers can easily get full trace information 
and errors can be located more easily. This level of control 
was particularly important in testing the transport pro- 
grams, where it was not practical to use the MPE debug 
facility. These tracing facilities remain in the released 
product, but cause little performance penalty since they 
are normally disabled. 

HPMAIL Data Bases 

HPMAIL uses two IM ACE/3 000 data bases to contain the 
user and network directory information and the users' elec- 
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trojiic desks, all maintained securely and reliably. 

All the HPMAIL programs on a single computer work 
with the same data base set. Items that are simultaneously 
owned by more than one user, for example a message deli- 
vered to two in trays, are held physically only once per 
system, with pointers to assert individual ownership. 

The HPMAIL GLOBAL data base is a director}- of all users 
known to this system The LOCAL data base contains local 
directory information about the users supported there, net- 
work directory information to control intercomputer 
transmission, and mail items, Mail items can be in trays t 
messages, queues of messages, individual text items, dis- 
tribution lists, or MPE files imported onto the data base — in 
fact, nearly anything an HP 3000 can store. 

The HPMAIL data bases perform three functions: direc- 
tory, storage, and item composition, The directory function 
enables HPMAIL to identify users when they sign on and 
determine those items that they can access. The directory 
also identifies users on mail distribution lists and enables 
user names as entered to be expanded to the full canonical 
form of name, location and sublocation. The network direc- 
tory functions enable HPMAIL to determine which com- 
puters to contact to send mail to a given location, how and 
when to contact the computers, and what telephone 
number or public data network (PDN) node name to specify. 

The storage functions enable HPMAIL to hold everything 
in the IMAGE data bases so that the information is always 
available, Thus HPMAIL will take an HPVVORD document 
and import it onto the LOCAL data base so that at some later 
time the transport system will be able to send it to another 
computer without requiring access to the sending user's 
MPE group, or having to wnrrv U tin 1 user deleted it. 

The composition functions enable HPMAIL to handle 
hybrid message types, to have the same message in several 
in trays or filing cabinet folders at the same time, and to 
operate queues of messages destined for different locations 
in the network. This leads to the important concept in 
HPMAIL that the simplest message contains two parts: a 
distribution list and some content (usually text), The mes- 
sage itself is a single item that contains these two parts. 
This split enables tin- transport mechanism to refer to the 
message as a whole, while the mailroom can access the 
distribution list, its primary concern, without having to 
scan the text- The end users also derive the benefit that they 
do not have to read the message distribution 1 ist but can go 
straight to the text, 

HPMAIL uses the IMAGE/3000 Data Base Management 
System for many reasons. Almost the least important is that 
it is a data base management system. The main reason is 
that it is solid and well-established and provides a Bnn 
foundation for a reliable product. 

It also offers its own space management, allocating new 
space as required and handling direct access problems 
transparently. Because of the hybrid nature of most 
HPMAIL items, the chain management system of IMAGE is 
very important, Jt handles pointer chains very easily. 
IMAGE uses shared data storage and shared buffering, add- 
ing to efficiency and performance. It has a good locking 
mechanism to prevent unreliable operation caused by mul- 
tiple updates of the same item. Finally, an IMAGE data base 
be dumped for security purposes very much faster than 



many MPE files. 

The main drawback to using IMAGE is that it is not 
designed to hold nonstructured items such as MPE files , 
and getting them in and out of the data base (importing and 
exporting) is a fairly lengthy process. We estimate, how- 
ever, that the time required to implement the project would 
have nearly doubled if the facilities of a system like IMAGE 
had not been available. 

Data Base Descriptions 

Figs. 2 and 3 show the schemas (definitions) for the two 
data bases. Two examples of the way HPMAIL uses the data 
bases in the execution of common functions are item stor- 
age and name searching. 

The most important data sets to the understanding of 
HPMAIL's item storage are the ITEM- HEADER, ITEM- 
STRrcTPRE and ITEM-CONTENT data sets on the Lt « 
data base. Items in HPMAIL are considered to be either 
basic, meaning that they can be represented by a single MPE 
file (for example a distribution list or an HPVVORD docu- 
ment), or composite, which have no MPE file form as such 
but are composed of Q number of basic items. An in tray is an 
example of a composite item, consisting of a header linking 
it to the messages in that particular in tray, 

Every mail item, basic or composite, has a type (e.g., user 
folder, message, text), a creator, and a subject. This informa- 
tion is kept in its item header. The JTEM-STRUCTrRE data 
set maintains the links between items thai make up compos- 
ites. For example, a message consists of a message header 
linked by two item structure records to the headers of its 
distribution list and content, The content of a basic item, the 
MPE file conlem. is held in &fl I TEM-CONTliNT data set, 
linked by IMAtrE pointers to its item header. 

In HPMAIL, every item is linked to at least one other, 
except for the root item, which we call item zero. If an item 
becomes detached from all its parents, which happens, for 
example, when a message is deleted from the in trays of all 
the users who received it, it becomes an orphan item and 
will be physically deleted from the data base by Hie mainte- 
nance program. 

Fig. 4 shows the HPMAIL object hierarchy in more detail. 
Although superficially complex, it is in fact quite efficient 
and lends itself very well to processing t>v IMAGE via the 
mail procedures. 

Searching for Names 

Every time a user enters a name into the user interface 
program, whether it is the user"s own name entered during 
the HPMAIL sign-on, or names on a distribution list, 




Fig. 3. The HPMAIL Global data base ts a directory of an 
users known to the particular system, 
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HPMAJL searches its directory for that name or a similar 
match. Names in HPMAIL are held in what we call canoni- 
cal form, which is: 

<SURNAME>,<FIRST NAME> <MLDDLE NAME>/ 
<LOCATION>y<SUBLOCATION> 

where the surname , first name, and middle name add up to 
no more than 36 characters, the location is up to six charac- 
ters long, and the sublocation is two characters long. Ca- 
nonical names are all uppercase, converted by means of an 
internal translation table to take care of national character 
sets. For example, the canonical form of user Ian John Ful- 
ler, location HP1600, sublocation 01 is: 

FULLER.IAN JOHN/HP 1600/01 

HPMAIL does not insist that the useT type in the full 
name, just enough to identify it uniquely on the data base. 
Thus if there are no other users with the surname PULLER 
defined on the data base, FULLER will be sufficient. If any 
doubt exists, the user interface displays those available and 
asks the user to choose one. Of course, user names must be 
unique to a mail node (locatlon+sublocation). 

When HPMAIL searches the data base for a name, it does 
so by first making a name probe from the surname supplied. 
The name probe consists of the first letter of the surname, 
followed by the next three nonrepeating consonants. For 
example, the surname FULLER yields the name probe FLR. 
This probe is taken as the key to a search of the NAME-INDEX 
master data set, which will give a chain of names that have 
this probe. The user interface scans down this chain com- 
paring each with the canonical form of the input name. 
There may be several degrees of match: all components 
agree, first names differ, locations differ, etc. If a perfect, 
nonambignous match occurs, then the user is not troubled 
further. Otherwise the user is given a choice of those availa- 
ble. The use of the name probe means that a slight misspell- 



ing of a user's name can sometimes but not always yield a 
choice that reveals the correct spelling of the name the user 
was looking for, For example, if the user types the surname 
COALMAN instead of COLEMAN, then the program will be 
able to give a choice of the correct name since both names 
result in the name probe of CLMN. 

In the case of the user sign-on process, the LOCAL data 
base is searched for the name, since it holds the name 
information for the users supported on that computer. For 
the construction of distribution lists, the GLOBAL data base 
is searched since it contains the directory of all the users 
known to that computer, but not necessarily supported on 
it, The user has no need to know where another is sup- 
ported; this is sorted out automatically. The name searches 
are done in a similar way on both data bases by mail 
procedures. 

User Interface 

The HPMAIL user interface provides the user with an 
environment designed to mirror the concepts familiar to 
office users. As mentioned earlier, the user is provided with 
an in tray into which incoming messages are delivered by 
the mailroom, an out tray in which messages the user sends 
are assembled and from which they are collected by the 
mailroom for transmission and delivery, a pending tray 
which holds messages awaiting acknowledgments (the 
user can find the acknowledgment status of any message in 
the pending tray by reading its distribution list] , a workarea 
which allows the user to create items and assemble them 
into packages before incorporating them into messages, a 
distribution list area which holds lists of users with whom 
the user may wish to communicate, a filing cabinet in 
which the user can file messages for future reference, and 
the administration area which gives users extra commands 
to do such utility functions as defining or changing their 
passwords and naming persons who may work on their 
behalf. 

The command set of HPMAIL is designed to reflect the 
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terminology used in offices. Examples of HP MAIL user 
interface commands are: 

READ to display an item on the user's terminal 

PRINT to print an item on the system line printer 

SEXD to start to send a message 

\IL to commit a message for transmission 

FILE to copy an item to a folder in the filing cabinet 

REPLY to send a reply to a message in the in tray. 

The function keys of Hewlett-Packard terminals axe used 
if possible to give the user an easy method of using the 
product. Function keys ft to f7 select entry to each of the 
areas listed above, ffl allows the user to leave HPMAIL. 

The prompt displayed by HPMAIL is another aid to the 
user. This changes according to the area. The in tray prompt 
is IN TRAY>, the filing cabinet prompt is CABINET>, etc. 
When the user has OPENed a folder the prompt changes to 
the first word of the folder's label, so a folder with the label 
User Group Presentation will, when OPENed, give the prompt 
USER>. 

Fig. 5 shows an example of HPMAIL' s main menu . which 
is displayed as soon as the user signs on, Following that, a 
typical user presses function key f1 , selecting the in tray to 
read any new messages. These messages are summarized in 
a list as shown in Fig. 6. Note also how the prompt has 
changed from HPMAEL> on the main menu to INTRAY> to 
indicate the change of area. 

Typing the command READ l after the IN TRAY> prompt 
causes the first message in the in tray to be displayed on the 
user's terminal, Fig. 7 shows an example of the format of a 
message displayed by HPMAIL. 

The user interface also offers an extensive HELP facility 
which is organized on three levels. Typing the HELP com- 
mand by itself gives general help about the area the user is 
in. For example, HELP in the filing cabinet gives the new 
user some idea of the purpose of this area and suggests some 
likely commands. The command HELP followed by another 
command name gives the user specific help about that 



command as it is used in that area. For example, typing 
HELP MAIL while composing a message explains the mean- 
ing of the command and how to use it. Finally, typing a 
question mark (?) in any area gives the user a brief list of the 
commands available. 

HPMAIL was designed to be translated easily into other 
languages. The translator doesn't need knowledge of the 
internal workings of the product or access to the source 
code, To this end, all messages produced by the product 
come from a central message catalog (which is currently 
about 4.000 lines long) while the HELP displays come from 
another catalog which is even longer, 

All user input except the content of messages is parsed by 
common parsing routines and co mm ands are recognized by- 
reference to a dictionary. The development team wrote a 
special utility to build this dictionary, which goes under the 
name of Webster. It is available to Hewlett-Packard software 
centers worldwide to help them adapt the product to their 
local language. Synonyms and common abbreviations for 
commands can be built into the dictionary as required for 
each language. 

Local character sets are handled by a translation table as 
part of the dictionary so that users may, in their local ver- 
sions, use commands containing their local characters, One 
limitation to the use of local character sets in HPMAIL, 
however t is that user names, locations and sublocations 
have to be in the standard USA ASCII code. This is because 
an HPMAIL network can span countries, not all of which 
may use the same conventions regarding extensions to the 
character set. 

User Interface Structure 

The HPMAIL user interface program is a direct analog of 
the data structures it supports in the LOCAL data base. It is a 
direct result of the maxim. ''Design the data structures cor- 
rectly and the applications programs will almost design 
themselves/' The program is a tree structure, as shown in 
Fig. 8, which follows the object structure quite closely. 

The outer block of the user interface controls all the other 
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components, which can broadly be broken down into ini- 
tialization, user sign-on, environment handlers, sign-off, 
and shutdown. The initialization module opens the data 
bases, the user's input and output files, and the message 
catalog and reads the dictionary from a disc file onto the 
user's stack. It initializes the mail common area with dJJ 
relevant data and generally prepares the program for execu- 
tion J t is also responsible for checking that the software has 
not been stolen and that incompatible versions of the 
software are not being used. The last task it performs is to 
print the HPMAIL banner on the user's terminal. 

The user sign-on module is the first that actually solicits 
input from the user [ by asking tor a name], The name allows 
the user's user record to be located in the LOCAL- USER data 
set of the LOCAL data base, and from that point on. the user 
interface can go to a specific point in the object hierarchy 
shown in Fig, 4. 

After a successful sign-on* control is passed to the main 
menu processor, the first and simplest of the environment 
handlers. This simply displays the list of options available 
to the user, along with the number of newly delivered 
messages in that user's in tray. The user is then prompted 
for a choice of area (environment) to enter next, This choice 
can be made by pressing the appropriate function key or by 
typing the corresponding number. 

The other environment handlers for the in tray, out tray, 
pending tray, work area, list area, and filing cabinet, are 
very similar in structure. They consist of five basic states: 
initialization, building a list file as a temporary MPE file of 
the current contents of the area [e.g., all the messages in the 
in tray], producing an initial LIST of the area to give the user 
the information about its contents, prompting the user for a 
command, and executing the command. 

Each command (READ, FILE, etc.) has its own executor, 
which handles the operation of that command in all areas. 
Once the environment handler has recognised that a certain 
command has been entered by the user, it passes control to 
the command executor for that command. It is the responsi- 
bility of the executor to determine whether the command is 
correct, possibly asking the user for additional information 
if necessary. If the command is correctly formed, the 
executor passes control to the action procedure for the 
command. This is often just a simple mail procedure, For 
example, the task of the FILE command executor is to de- 
termine what the user wishes to file, and where. This is 
resolved internally into a pair of internal item numbers in 



the ITEM-HEADER data set. These are presented to the action 
procedure for the FILE command, which is the mail proce- 
dure MATTACH, whose task it is to perform the required 
attachment, linking, say , an in tray message to the incoming 
day folder in the user's filing cabinet. 

Command-Based User Interface 

We are frequently asked why we adopted a command- 
based user interface for HPMAIL when many of Hewlett- 
Packard's Interactive Office products have standardized 
upon point-and-push interfaces, that is^ the user positions 
the display cursor and pushes a function key. This question 
caused a considerable amount of discussion in the develop- 
ment and marketing teams during the design phase of the 
product and we finally decided in favor of an unsophisti- 
cated command- based interface for two main reasons. 

First, we realized that many of the potential users of our 
product would be managers, working away from limit 
desks, perhaps in hotel rooms, on hard-copy terminals con- 
nected to their office HP 3000 by a slow-speed telephone 
line. We thought that these users would derive a major 
benefit from using HPMAIL and so we designed our prod- 
uct to be no more demanding of a terminal than that it be 
teleprinter-compatible, We would not go so far as to claim 
that the HPMAIL user interface works well on every termi- 
nal that can be connected to an HP 3000 , for we have not 
tried them ail, However, we would be very interested to 
know of any upon which it does not work. 

The other main reason for adopting the command-based 
interface is that, for regular users, such an interface is far 
quicker to use than one where you have to cycle through 
several screens just to access the menu you require, Users 
often comment that, as long as you are not making errors, 
the user interface is extremely terse. It does not usually ask 
for confirmation of actions, nor indulge in long dialog about 
exactly what to do. This agrees with our belief that an 
electronic mail system is of little use to an occasional user 
and to derive major benefit from it. it must be used regu- 
larly. Otherwise users would cease to rely on it as a timely 
communication medium, Regular users, we believe, do not 
want verbose or long- winded user interfaces, they know 
what they want to do and do not want the software to get in 
the way. 

Ideally* of course, we would have written a user interface 
for every level of user who might encounter our product. 
However, we compromised with one we thought would 
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please the maximum number of people most of the time. 

One drawback of a command- based user interface is that 
it is often perceived as being harder to learn initially than 
point-and-push interfaces. Many of our users are busy man- 
agers who have no time to go on long product training 
courses or to wade through long manuals just to learn how 
to send a simple message, J was told once while I was testing 
the product with some Hewlett-Packard managers in the 
United States that if they could not learn the essentials of 
the product in a maximum of thirty minutes it would not be 
accepted. To this end we developed an on-line training 
package for the product, known as thn Interactive training 
facility. This gives users the opportunity to learn about 
those aspects of the product they need to use at their own 
speed in their own time. We find this to be an extremely 
valuable facility in getting the product used throughout the 
company- 

tt is interesting to note white discussing user interfaces 
that the HPMAIL configurator program has a point-and- 
push user interface based entirely on VPLUS/3000. We felt 
that the configurator was an ideal application Ebtf such an 
interface and makes the potentially complex process of data 
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Fig. B. The HPMAtL user interface program has a tree struc- 
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base building, configuration, modification, and expansion 
far easier to achieve for system administrators, 

Transport System Overview 

As stated previously, one of the major product objectives 
for HPMAIL was to provide a system in which the end user 
did not need to become involved with the intricacies of 
message routing and transmission, understanding DS/3000, 
or dealing with line failures, message congestion or any of 
the many other problems that can befall a multicomputer 
messaging system. 

Once a user MAILs a message it is removed from the nut 
tray by the mailroom and handed over to the transport 
system for sorting, transmission, and delivery- The user can 
the progress of the message by setting an acknowl- 
edgement on the message and monitoring it in the pending 
tray while it is sent to all the recipients, wherever they may 

Pig, 9 shows an overview of the data and control flow 
required to implement the store-and-forward system used 
in HPMAIL 

The transport system is implemented by background }obs 
communicating via IPC files. The jobs are known as the 
mailroom, transport manager, and at least one master truck 
communicating with a slave truck on a remote computer. 

The mailroom has two basic functions, first to collect 
messages from users' out trays, and second to deliver in- 
coming messages to recipients on message distribution lists 
where the users a re supported on the same computer. It also 
handles delivery acknowledgments, autoforward, and 
autoanswer, The mailroom is structured internally in two 
halves. The outgoing half deals with mail collection and 
sorting, and the incoming half deals wnth local mail 
delivery. 

Outgoing mail originates from the user interface in re- 
sponse to the user's MAILing a message created by the SEND, 
FORWARD or KKPLV commands. The IPC message sent to the 
mailroom when a message is MAILed identifies the specifti 
m>'sv,i^' id rjis i tut irav \\\n\ ha.s been i ommitted fot *r«in*- 
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Fig, 9. Overview of the data and control flow required to 
implement the store-and-forward system used in HPMAiL. 

mission, The mailroom responds by accessing the message 
and scanning its distribution list It builds an internal list of 
the number of unique mail nodes (local or remote) that the 
message is bound for and then attaches the messages to the 
node queues for the correct destination nodes. For locally 
bound messages the outgoing mailroom sends an IPC mes- 
sage to its Incoming counterpart to deal with the delivery. 
For remote messages it sends a message to the transport 
manager alerting it of the new maiL If an outgoing message 
requires any acknowledgment, the mailroom attaches the 
message to the sending user's pending tray, ready to receive 
the acknowledgments as they come in. The last action it 
performs is to detach the message from the sending user's 
out tray. 

The incoming half of the mailroom deals with mail 
originating from tw^o sources. First are the local messages 
sorted by the outgoing half. Second, the incoming mail- 
room receives IPC messages from a slave truck operating on 
its computer to handle messages received from a remote 
computer and to be delivered locally, 

In each case, the incoming mailroom examines the mes- 
sage distribution list to determine to whom the message is 
to be delivered. It then locates the required users" in trays on 
the LOCAL data base and attaches the message to them It 
also has to handle the various types of acknowledgment 
that can be received, amending the user's pending tray copy 
of the message with the fact that the acknowledgment has 
been received. Its other main tasks are to generate delivery 
at knowledgments for the message if necessary and to per- 
form any autotorward or auloreply that a receiver has set. 

Transport Manager 

The transport manager is another background job. Its 
function is to control and schedule the operation of 
HPMAiL in sending mail to remote computers. It maintains 
tables of mail nodes for which mail is waiting and the 
possible routes that it can use to move the mail. This infor- 
mation is derived from the HPMAIL system configuration 
specified using the configurator program. Every- fifteen 
minutes the transport manager receives a clock tick from its 



son process, the clock tick generator. This causes it to 
reexamine its priorities and reschedule the master trucks 
under its control if necessary. 

The transport manager is constantly striving to ensure 
that the remote mail nodes with the highest-priority mail to 
send are being serviced by the available master trucks, Once 
it selects an available mail node, together with an available 
route to another computer, it sends an IPC message to a free 
master truck instructing it to establish a DS/3000 connec- 
tion with another HPMAIL computer. Once the master truck 
has reported that it has done this successfully, the transport 
manager instructs the truck to clear a certain remote node 
queue. Once this has been done, the master truck reports 
back, ready to receive further instructions. 

The transport manager is capable of controlling op to 
eight master trucks simultaneously, although it would be a 
very ambitious network that required this level of re- 
sources, 

The master truck receives IPC instructions from the 
transport manager and handles all the interaction with DS/ 
3000 and PTOP to move mail physically between comput- 
ers. 

The first instruction received by an idle master truck is to 
establish connection with a certain remote computer (iden- 
tified by name) using a specified DS/3000 line, and if nec- 
essary, a specified telephone number or public data network 
node name. It uses an MPE DSL1NE command to open a line 
to the remote computer, followed by an MPE REMOTE HELLO 
r:ummand to establish a remote session, it then attempts to 
create and activate a slave truck on the remote computer, 
using the DS/3000 intrinsic POPEN. If the slave truck is 
successf nlly awakened the master truck determines that it 
is, in fact, communicating with the correct remote comput- 
er by interrogating the slave for its computer name. Once 
this protocol has been observed, the master truck reports 
back to the transport manager "truck idle with DS line 
open" and awaits further instructions. 

The next command received by the master truck in the 
message transmission operation is the move mail com- 
mand. This instructs the master truck to transmit mail from 
a given remote node queue on the LOCAL data base, The 
master truck is responsible for serialising messages from 
the data base and packing them into transmission buffers 
for sending to the remote computer via the PVVRITE PTOP 
Intrinsic, 

At the other end of the communication link the slave 
truck accepts these transmissions, if possible, and recreates 
the message on its computer, After the message has been 
completely transmitted, the slave truck deserializes the 
message onto its data base. Depending on the ultimate des- 
tination of the newly received message, the slave truck 
either alerts the mailroom for locally bound messages or its 
own transport manager for messages that are destined for 
onward transmission. Once the master truck has sent a 
complete message successfully, it detaches that message 
from the remote node queue, since responsibility for it has 
now passed to the next computer in the chain. 

This process is repeated for all the messages that the 
master truck has to send. Once the master truck has com- 
plied with its instructions to move mail, it reports back to the 
transport manager "truck idle with DS line open." The 
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transport manager either responds with an instruction to 
begin transmitting messages bound for another mail node, 
taking advantage of the open DS line, or instructs the master 
truck to terminate the link if there is no more mail to be sent 
on that route. 

The main challenge in designing the trans i 
mechanism was to provide for all the failures that can take 
place during transmissions over communications . 
Examples of the type of problems that have to be bandied 
are; 

■ Inadvertent connection to the wrong computer, perhaps 
because of an incorrectly dialed telephone number 

a Finding that the remote data base cannot accommodate 
the message to be sent, either temporarily because of 
congestion t or semipermanently because the data bases 
are not sufficiently large 

m Configuration errors resulting in transmissions being re- 
fused or an infinite loop being set up 

■ Line failure during any stage of the process. 

Since detachment from a node queue is the last operation 
that the master truck performs, and this happens only after 
it has been determined that the message was transmitted 
successfully, it is unlikely that messages will be lost be- 
cause of line failure. However, It is possible that HPM.AIL 
will send messages twice in some circumstances. 

Why Use PTOP? 

We chose the prog ram-to- prog ram intrinsics provided by 
DS/3000 in preference to the other methods of transmitting 
files across DS (distributed systems) connections for four 
reasons. First, PTOP ensures that there is a communicating 
process at the other end of the DS line to receive the maiL 
Without it, we would have had to implement yet another 
level of IPC communication to ensure that the remote com- 
puter was aware of the mail being delivered to it Second, 
the performance of PTOP is superior to, for example, remote 
data base access [RDBA], since in good circumstances, the 
master truck can be assembling transmission buffers for the 
next transmission at the same time DS is taking care of the 
transmissirm Di the previous buffer over the line, This 
makes optimum use of the communications line. 

Third, PTOP provides very good application program 
control over the communication activity with the provision 
of a tag field in the PTOP intrinsics that can be used to 
send status, control, and block-level acknowledgments at 
the same time as the buffer transmissions, Lastly, the PTOP 
intrinsics are implemented on other Hewlett-Packard com- 
puters, for example the HP 1000 Technical Computers, giv- 
ing us the option of using these machines as mail nodes in a 
mixed DS network. 

By removing the transport mechanism to a completely 
separate layer of the product we will be able to take advan- 
tage of enhancements to Hewlett-Packard's data communi- 
cations products as they become available with minimal 
disruption to the produces users, It is notable that the 
HPMA1L transport mechanism uses only supported fea- 
tures of DS/3000 and works entirely in user mode. This, we 
feel, contributes greatly to the robustness of the product. 
This remark applies to the product as a whole. Tn fact the 
only line of privileged code in the product is one where the 
system cold load identity is obtained, This is required to 



maintain system integrity, since we have to know if there 
has been a system restart since the data bases were last 
accessed. 
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Integrated Tools Improve Programmer 
Productivity 

This software subsystem for the HP 3000 Computer System 
saves program development time by giving the 
programmer access to several utilities through a single 
command interpreter. 

by Anil K. Shenoy and Carolyn M. Bircher 



HPTOOLSET IS A SOFTWARE SUBSYSTEM that 
provides an integrated program development envi- 
ronment to improve programmer productivity. 
Through a single, friendly user interface, it offers pro- 
grammers access to several programming tools needed fnr 
software development. It lets programmers perform multi- 
ple functions simultaneously and access information about 
other program development functions being performed. 

HPTooIset runs under the MPE operating system on the 
HP 3000 Computer System. The first release is geared to- 
wards improving COBOL II programmer productivity but 
HPTooIset is structured such that many of the features do 
not depend on any specific language, 

The phases of implementing a software program include 
source code creation, modification, compilation, execu- 
tion, and testing. These steps are executed repeatedly dur- 
ing the life of a program and can be very time consuming, 
HPTooIset relieves the programmer of the responsibility of 
manually directing program flow through each of these 
steps and minimizes development lime by allowing the 
programmer to move between the different phases of pro- 
gram development without leaving the HPTooIset envi- 
ronment. Since program development is often a team effort. 
HPTooIset promotes sharing of information between pro- 
grammers, which in turn increases the effectiveness of the 
programming effort, 

HPTooIset offers the following aids towards improving 
productivity: 1 

■ Menu and labeled function key interface 

■ Ability to perform multiple functions without exiting 
and reentering subsystems 

> Sharing of files between team members through version 

management 
a Full-screen editing with a point-and-push philosophy 

(Le. t the user positions the cursor and pushes a function 

key) 

■ Background compilations and on-line listings 

m Point-and-push method to find compilation errors 

■ A GO key to eliminate the manual steps between compila- 
tion and execution 

■ Dynamic symbolic debugging 

* Ability to go directly from symbolic debugging to the 
related compilation or source listing 

■ Context-sensitive HELP facility. 



Basic Concepts 

The following concepts are fundamental to an under- 
standing of HPTooIset, 

A workspace is a directory of the files that are used in the 
development of a program. It represents the programmer's 
development environment The programmer is required to 
create or reference a previously created workspace before 
executing most HPTooIset functions. 

The HPTooIset access method, TSAM is a customized 
file access mechanism that is built on top of MPE's file 
system. It provides, among other features, the ability to 
define and access versions of changes made to a source file. 
HPTooIset provides interface procedures for compilers and 
other procedures that wish to access TSAM files. The 
COBOL II compiler uses these procedures to read TSAM 
source files. A conversion utility is also provided to convert 
MPE ASCII files or KSAM/300Q [keyed sequence access 
method) files to TSAM format. Only TSAM files can be 
edited via the HPTooIset editor. 

When a source file is compiled it is translated from a 
higher- level language, like COBOL II, to a lower-level lan- 
guage of machine instructions, Source files are compiled 
into a user subprogram library [USL) file. MPE's seg- 
menter is called by HPTooIset when the USL file is to be 
prepared into a program file. The segmenter binds all the 
needed routines to the program so they can be found by the 
system when the program is executed. Each workspace has 



User 4 ^ 




Workspace 
Manager 



Symbolic 
Debug 



TSAM I/O Procedure*, 

Environ merit Table Access 

Routines, and Otner Utilities 



Ftg. 1. HPTooIset program structure. Ail activities are man- 
aged by the EXEC. TSAMts the HPTooIset file access method, 
which allows multiple versions of a file to reside withtn the 
same file. 
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one USL and one program file associated with it. Multiple 
source files can be compiled into a single USL file. 

Message files are used for communication between pro- 
cesses. They act as a first-Ln-first-out queue of records with 
one process writing and the other reading. If the queue is 
empty, the reader process is put into a wait state until a new 
record is written. When a record becomes available, the 
read is satisfied and the record is deleted from the queue. 

The HPToolset EXEC 

Fig, 1 shows the basic components of HPToolseL All 
activities thai occur within HPToolset are managed by the 
EXEC. It interprets the user input, determines if it is valid 
for the current context, and calls the appropriate processor 
to act upon it. By having all of the HPToolset utilities 
operate under the umbrella of a single command interpre- 
ter, a consistency is achieved which has not existed be- 
tween the unrelated tools previously provided on the HP 
3000, The user need learn only one interface and time is 
saved by not having to exit from one utility before entering 
another. 

The EXEC also makes it possible for the programming 
tools to work together. It allows several functions to be 
active at one time. For instance, a compiler listing can be 
displayed at a debug breakpoint, or one file can be read 
while another is being edited. This relationship between 
the tools is maintained by means of an environment table. 
This table includes information about all current HPToolset 
activities, It is used by the EXEC to ensure thai commands 
axe not executed in an unsuitable environment. It also 
makes it possible for the user to see a list of all activities 
related to the current workspace by issuing a single com- 
mand. 

Because the EXEC can determine what other functions 
are currently being performed, it can also provide context- 
sensitive defaults. For instance, if the Edit function key is 
pressed while a program is being debugged, the user will 
not be prompted for an edit file name- Instead, the source 
file related to the program being debugged will automati- 
cally be displayed such that the first source line on the 
screen corresponds to the current breakpoint location. Also, 
when the HELP key is pressed, it will display the HELP 
screen most appropriate for the current context. If the error 
has just occurred, it will give furl her explanation of the 
message and/or a corrective action. Otherwise, an overview 
of the most recent function is provided. 

Even though the environment luble resides in the global 
variable area, it is not accessed directly by any of the 
HPToolset command processors- Special- purpose routines 
were written to retrieve and update information in the table. 
By requ iring all processors to access the table through these 
routines, control is centralized and a mechanism is pro- 
vided to ease future debugging of the product. 

TSAM 

The HPToolset access method, TSAM, provides a 
mechanism for multiple versions of a file to reside within 
the same file instead of having to define a different Rte fol 
each set of changes. 

Muring the program development cycle each source file 
goes through many changes. These changes are typically 



cycled through compile, prepare* and execution iterative!} 7 
until the programmer is satisfied that the changes are stable. 
At this point the programmer may wish to freeze the source 
so that others can share it. Before HPToolset, to make 
further code modifications the programmer would have to 
copy the contents of the frozen source to another file so 
modifications could be made to it while the team members 
accessed the frozen source fUe, With HPToolset, this func- 
tion can be done by establishing a new version of the file by 
an HPToolset command and designating the frozen source 
as the reference version, that is t the version that others will 
access by default. 

For example, let us assume that a file goes through the 
following changes; 
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Here a t b. c. and d represent COBOL I] source lines. Line a 
was changed in version 2 but not in version 3, Line b was 
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Fig, 2. HPToolset supports both random (keyed) and sequen- 
tial fife access 12-byte alphanumeric keys are organized in a 
modified B-tree structure called a BNree The trees shown 
here have only two levels, but tn general there are many inter- 
mediate levels between the root and leaf levels At each level 
are one or more key blocks containing several key entries that 
include pointers to tower levels Blocks at higher levels are 
considered parent blocks of the tower-level blocks they point 
to. In the HPToolset Bt-tree all keys are represented at the leaf 
level to aid sequential access, and each leaf key entry con- 
tains vanabie-iength version information (Vl) t including point- 
ers to the data associated with the key value. 
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deleted in version 2 and added again in version 3. Line c 
was left unchanged. Line d was first introduced in version 2 
and modified In version 3, 

Before HPToolset, these versions had to be saved in three 
separate files. HPToolset saves the changes associated with 
each version of the file and at retrieval time returns all 
the records relevant to the version being accessed. Log- 
ically, therefore, the user sees each version as a separate 
file, but physically they are all in the same file. This saves 
disc space and eliminates the bookkeeping of associating 
changes with file names. 

When a TSAM file is created it has one version — version 
1. This is also the latest version. After the development 
cycle referred to earlier, the programmer freezes version 1. 
The latest version is automatically updated to version 2, 
Only the latest version, version 2 in this case h can be mod- 
ifiecL The programmer can set version 1 as the reference 
version so that other users will access version 1 by default. 
After making further changes to version 2, the programmer 
may wish to freeze it, Version 3 is now the latest and is the 
only one that can be modified . The programmer may choose 
to have version 1 continue to be the reference version or 
move the reference to version 2. While the la Lest version is 
being modified other versions of the file may be read con- 
currently. HPToolset also provides commands to purge one 
or more versions of a file, to label the versions with com- 
ment strings, and to list the changes between versions, 

TSAM supports both random [keyed) and sequential ac- 
cess. Data records are stripped of trailing blanks before 
storage. The keys are 12-byte ASCII alphanumeric keys and 
are organized in a modified B-tree structure. 2 For purposes 
of this discussion we will refer to this modified structure as 
a Bt-tree. The B-tree structure was modified primarily to: 

■ Optimize sequential access to the file without sacrificing 
random access performance. This is because the majority 
of the accesses made by the HPToolset editor are sequen- 
tial, This is especially true in visual edit mode where 
blocks of data are read for screen display. The Bt-tree 
structure attempts to minimize tree traversals, thereby 
minimizing key block swapping. This is important when 
constraints do not allow multiple key blocks to be 
memory-resident concurrently. 

■ Keep version-related information with the key indexes. 
Fig. 2 shows the B-tree modifications, In Fig, 2. the num- 
bers symbolize key values and VI represents variable-length 



version information T including pointers to the data as- 
sociated with the key values. The major differences be- 
tween the B-tree and Bt-tree structures are: 

■ Each leaf entry in the Bt structure consists of the key and 
version information, which is of variable length. In the 
B-tree each key entry has a fixed length, 

■ Leaf key blocks are chained forward and backward in the 
Bt-tree. 

■ In a B-tree both leaf and nonleaf entries contain pointers 
to the next lower level. Even though these are unused in 
the leaf {since the leaf is the lowest level), space is re- 
served for them, This is avoided in the Bt-tree, saving 
wasted space, 

■ In the Bt-tree all keys are represented at the leaf level. 
This is to provide for sequential traversal without ha ving 
to read in the parent blocks, Although this introduces 
data redundancy, it improves sequential access time, 
especially if multiple key blacks cannot be held concur- 
rently in memory, 

Workspace 

A workspace is a TSAM file with one version. Each data 
record is 80 bytes long. The workspace is a directory of 
the files that pertain to the programmer's development en- 
vironment. 

A file is considered owned by a workspace if it is created 
via the HPToolset editor, converted from ASCII or KSAM, 
or copied from another workspace while the programmer is 
associated with this workspace, 

A file is considered used if the programmer wishes to 
share it without making a copy of it. In using a file the 
programmer will access the reference version of that file by 
default, but can explicity override the default and access 
other versions. 

A workspace contains information about owned and used 
files, such as the total number of active versions in the file, 
the reference version of the file, the source language (cur- 
rently COBOL II or "other"), and whether it is a main pro- 
gram or a subprogram. In addition, the names of the USL 
file, the program file, and on-line listing files are main- 
tained in the workspace, The programmer can display this 
information via the Show Files and Program commands. 
Fig. 3 and 6 show these displays. 

Information in the workspace is partitioned by key ranges 
for easy access. Workspace control information is in a range 
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displays information about the files 

owned and used by a workspace. 
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from 000001000000 to 000002000000, Used file informa- 
tion lies between 000002000000 and 000003000000, owned 
file information lies between 000003000000 and 
000004000000 and so on. 

When HPToolset executes a command that opens a 
source fiJe. it reads the workspace to determine if (he file is 
used or owned. If it is owned, the latest version of the file is 
accessed by default. If it is used, the reference version is 
accessed by default. During compilation and execution, the 
workspace is read to obtain the names of the USL and 
program files, 

User Interface 

The HPToolset user interface is designed to be friendly 
and yet provide the flexibility required to support multiple 
utilities. An effort was made to make the commands natural 
and to prompt the user for omitted parameters rather than 
giving a syntax error and requiring that the entire command 
be retyped. 

The terminal's function keys (also called softkeys) are 
programmed to correspond with most of the commands. 
The function keys are designed so that there are always two 
sets available, with eight keys in each set. One set, known as 
the permanent set. always remains the same. It contains 
functions that are relevant in most HPToolset environ- 
ments. The key functions in the other set change as the 
environment changes so that the most useful set is present, 
One key in every set is reserved for switch ing back and forth 
between the permanent and context-sensitive softkey sets. 

The function key labels for at least one set are always 
displayed on the terminal screen. On HP 262x-series termi- 
nals, the labels for the active set are displayed in the built-in 
template at the bottom of the screen. Both the permanent 
and context-sensitive softkey sets are displayed side by side 
at the top of the screen on HP 264x terminals, as shown in 
Fig. 4. Arrows between the sets indicate which is active. 
The labels are displayed in a highlighted template, which is 
protected by memory lock. To change the labels, memory 
lock is turned off, the cursor is moved to the top of the 
screen to write the new labels, memory lock is turned back 
on, and the cursor is returned to its original position so that 
no other contents of the screen are changed. 

VPLUS3000 was used to Implement the menus for 
HPToolset. Instead of having thr user press the ENTER key 
to transmit input, the VPLUS/3000 autoread option is used. 
Appropriately labeled function keys are provided with all 
menus, and when one of them is pressed. HPToolset does 
the autoread to pick up the terminal input before perform- 
ing the desired function. This provides a menu interface 
consistent with the user interface for the rest of the product. 

Editor 

HPToolset includes a visual editor. It displays a portion 



of the edit file on the screen. This can be ed ited d irectly with 
the terminal's cursor movement and editing keys. The ter- 
minal is strapped so that all cursor actions are transmitted 
to HPToolset. The movements are recorded into a buffer 
which is evaluated when the return key or any function key 
is pressed, or when it is full. All changes recorded in the 
buffer are written to the edit file with each buffer evaluation 
to ensure data integrity if a system crash should occur 
during editing. An UNDO command is provided to allow the 
user to cancel the last changes written to the file. 

Function keys are also used in the visual editor to imple- 
ment movement from one location to another in the edit file 
and to facilitate editing functions, such as MOVE and COPY, 
that cannot be done with the terminal editing keys, One of 
the keys. labeled MARK, is used to select lines to be moved or 
copied and to select the destination. Once the lines have 
been selected, the operation can be completed by simply 
pressing the MOVE or COPY function key. 

Since a language is associated with all TSAM source files, 
the editor is able to set editing options to the values most 
appropriate for each file. The HPToolset editor sets tabs and 
margins differently, depending on the language associated 
with the file. Of course, any of the options set by HPToolset 
can be overridden by the user, 

tig. 5 shows a typical visual edit screen. 

Program Translation and Execution 

As mentioned earlier, after a source file is created, a 
number of translation steps are needed before it reaches a 
stable state. The steps are compiling, preparing, executing, 
and debugging. 

When a workspace is entered, HPToolset provides ih - 
fault names for USL and program files. The programmer can 
specify different names and the options to be used while 
preparing the USL file, By issuing the Program com- 
mand or pressing the function key. the programmer can 
display compile-related information on the source files in 
the workspace, This is shown in Fig. 6, The programmer 
can now mark the file[s) to be compiled and press the 
ile function key. HPToolset maps this into one or more 
calls to the COBOL 11 compiler. 

The compile process is created in background mode so 
that HPToolset is active while the compiler is executing. 
HPToolset sets up file equations with the formal names that 
COBOL II expects for the source, USL, listing and work* 
space files. Three message files are used to communicate 
information during compilation: let's call them MFl, MF2, 
and MF3. The compiler directs its listing to MFl and com- 
pletion statistics such as number of errors and compilation 
time to MF2. 

If the file being compiled is owned by the workspace, an 
on-line listing is generated. If not. the listing is sent to the 
printer. HPToolset reads MFl and transfers data to a TSAM 
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Fig. 4. HPToolset provides two 
eight-key groups of function keys 
(softkeys), a permanent set (left) 
and a variable set that changes 
with the environment . On terminals 
capable of displaying both sets, 
arrows indicate which set rs active. 
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Fig. 5. A typical HPToolset visual 
edit screen. 



file until there is no data left to read and there is no writer 
associated with MF1. This signals completion of the com- 
piler's listing activity. The programmer can scroll through 
an on-line list ing interact! veJy, mark a line or an error if "any, 
and have HPToolset display the corresponding line in the 
source lite. Pressing the PRINT key produces a hard copy of 
the listing. 

Completion of compilation is signaled by MF2's having 
data in it and no write activity. HPToolset informs the 
programmer that the compilation is completed, via the user 
interface routines, It now checks to see if another file is to 
be compiled [i.e., more than one file was marked w T hen the 
user pressed Compile), [f so, information on this compile is 
passed via MF3. Compiler creation and the subsequent 
sequence of events is repeated. 

After compilation the next step is to prepare the USL file 
into a program file. This is done by pressing the PREP key. 
Any prepare options specified in the workspace are now 
honored. Alternatively the user can type in the PRFP com- 
mand and specify the options. HPToolset now creates a 
temporary file and writes the MPE segmenter commands 
necessary to perform the PREP function to it. It then invokes 
the segmenter and directs it to get its input from the file. 

The final step is to execute the program file. This is dune 
by pressing the RUN key. The program executes in fore- 
ground mode. If symbolic debug w T as not requested, 
HFToolset is inactive until program execution is com- 
pleted. If symbolic debug was requested, the program 
pauses at the first executable statement and control is re- 
turned to the programmer so that execution can be moni- 



tored. 

The programmer can combine the compile, prepare, and 
execute steps by pressing the GO function key. To do this 
the programmer first issues the Program command to dis- 
play the source files in the current workspace, then marks 
the files and presses the GO key. The file{s) are compiled, 
prepared into the workspace-defined program file, and exe- 
cuted. 

Symbolic Debug 

The debugger in HPToolset allows programmers to set 
breakpoints, trace program flow r , display variable values, 
and change the values of variables by using the symbolic 
names used in the program source, Debugging time is saved 
by eliminating the need to determine the octal addresses of 
program locations or data items before accessing Lhem in 
the debugger. 

To implement this, it was necessary to save additional 
information in the USL [object] and program files. The 
COBOL II compiler was modified to store the symbol table 
information into the USL file, Three new USL header types 
were added to hold this information, two to hold the PMAP 
information* and one for all other symbolic information 
such as the addresses associated with data items and pro- 
gram statement numbers. 

The compiler also inserts a PCAL [procedure call) instruc- 
tion at the beg i n ning and end of the main program and each 
subprogram, and at the beginning of each section and 
paragraph. These instructions pass control to SDB SPY. 

*PMAP = program map, a lisl of procedures w$hin a program 
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fifes. To compile a program file, the 
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which is a procedure that acts as the communication link 
between the HPToolset debugger and the user program. The 
PCALs are used by SDB SPY for tracing program flow. 

During the linking process, the symbol table information 
is passed from the USL file to the program file. The seg- 
menter creates a son process, called SEGSVM, which takes 
the information from the USL file, sorts and reformats it. 
and adds it to the program file, Several new MPE intrinsics 
(routines) can be called by HPToolset to access this informa- 
tion for converting symbolic names to the corresponding 
octal addresses. 

Of course, His not necessary to include this extra infor- 
mation in program files that are not going to be run with 
symbolic debug. By default it will not be added to the USL 
file by the compiler. A SCONTROL 5YMDEBUG statement 
must be included at the beginning of the source files for 
which the symbolic debug information is desired. The seg- 
menter will automatically pass it from the USL file to the 
program file unless the NOSVM parameter is included in the 
PREP command. Including the NOSYM parameter will also 
cause all of the inserted PCALs to be converted to MOP 
instructions. 

As soon as HPToolset creates a user process to be ru n with 
symbolic debug, it does a handshake with SDB'SPY, Com- 
munication between HPToolset and SDB'SPV is executed 
via three message files. HPToolset sends the names of the 
message files in which it will write and receive messages 
(MF2 and MF3) to SDB'SPY in MFl. It then initiates a read 
from MF3 and waits for a reply. Because of the inserted 
PCAL instruction, SDB'SPY gets control as soon as the user 
program is created. SDBSPY returns the handshake by writ- 
ing a message to MF3 to inform HPToolset that it is ready to 
receive a debug command. 
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Fig. 7. intrinsics (routines) were added to tne HP 3000 operat- 
ing system, MPE, to facilitate converting between symbolic 
names and octai addresses intrinsics were also added to cail 
tne MPE debug facility programmaticafly for setting and cfear- 
mg breakpoints. MF2 and MF3 are message files used by 
HPToolset, 



When the user enters a symbolic debug command to set or 
dear a breakpoint, HPToolset determines the PMAP name 
and offset for the symbolic location or statement number 
and passes Ihem to one of the new MPE intrinsics. The 
intrinsic converts them to the corresponding octal address. 
HPToolset then passes the address to SDB'SPY through 
MF2. SDBSPY calls the MPE debug utility programmati- 
caliy to set or clear the breakpoint. This capability was 
added to MPE debug by the addition of two intrinsics, 
SETBREAKPNT and CLEAR BREAKPNT. When tne operation 
has been done, SDB SPY returns the status to HPToolset in 
MF3, Fig. 7 diagrams this flow of events. 

When the user resumes program execution- HPToolset 
sends a message to SDB'SPY and then initiates a read from 
MF3. This puts HPToolset in a wait state until SDB'SPY 
satisfies the read. One of the parameters passed to the 
SET'BREAKPNT intrinsic is an address in SDBSPY where 
control will be passed when the breakpoint is reached. 
When SDB'SPY gets control at a breakpoint, it writes the 
program location to ME3 to satisfy the read which was 
issued by HPToolset. HPToolset then converts the octal 
breakpoint location to the symbolic equivalent, displays it, 
and prompts the user for a command. 

When a DISPLAY or MOVE command is entered to display 
or change the value of a symbolic data item, the symbolic 
name is converted to an address in the data stack and a 
length [in words). The request is then passed to SDB SPY 
through MF2. SDBSPY can directly access the program data 
stack since it is called by the user program. It returns the 
contents of the requested locations to HPToolset where it is 
formatted and displayed, 

Context-Sensitive HELP 

As was mentioned earlier, HPToolset has a context sensi- 
tive HELP facility. This facility provides an overview of each 
of the utilities, specific text about each of the commands, 
and further explanation of error messages, The command 
descriptions are contained in a TSAM file, keyed on the 
internal command numbers which are used by the com- 
mand interpreter. By using the same command numbers as 
are used by the command interpreter, the HELP facility can 
share the procedures for converting command names to 
numbers, and can easily find the correct syntax for the 
iiarul just entered by picking up the current command 
number from the command interpreter. This is used 
if HELP is requested immediately after receiving a syntax 
error. 

When a nonsyntax error is displayed T the error number is 
saved. The I IELP facility uses that number to locate the error 
explanation and corrective action. This information is ob- 
tained from the error catalog where it has been included as 
comment 1 ines immediately after the error text. After MPE's 
GENMESSAGE intrinsic has been called to locate the error 
message in the catalog, the File pointer is left in a position 
that makes it easy for the HELP facility to find the error and 
read the comment lines following it The result might look 
like: 

>>ADI) ni 

"*No file currently open for editing. [85) 

»HEXP 



FEBRUARY 19B3 HEWLETT-PACKARD JOURNAL 35 



)Copr. 1949-1998 Hewlett-Packard Co. 



Cause: A command was entered which is only valid while an 

Edit file is open, and there was not one open. 
Action: Do an Kdit ctmimarul forrf ore reentering the command, 



Technical Summary 

The IIPToolset subsystem is written entirely in SPL, the 
HP 3000 systems programming Language, It is currently 
made up of 260 source files which contain a total of 1 30,000 
lines of code. HPToolset is contained in two program files 
named TOOLSET and TSETUT1L. TOOLSET is the primary 
program file and contains 37 segments, TSETUTtL contains 
one segment and is created as a separate process by 
TOOLSET to implement background compiles and other 
special functions. 

In addition, two new segments were added to the system 
segmented library to support HPToolset. Tliey contain the 
I/O procedures for accessing TSAM files and SDB'SPY. 

Several existing products were enhanced to support 
HPToolset. The COBOL compiler, the MPE segmented 
and the MPE program loader were all changed to handle the 
symbol table and PMAP information in the USL and pro- 
gram files. The COBOL II compiler was given the ability to 



read TSAM source files and workspace files. Also, intrin- 
sics were added to MPE for programmatically calling the 
MPE debugger to set and clear breakpoints and to facilitate 
the conversion of symbolic locations to the corresponding 
octal addresses. 
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